redis连接必须用redis://协议；需统一session key前缀、严格对齐gc_maxlifetime与redis过期时间；配置超时重试并启用健康检查，确保跨机session共享稳定。
Redis 连接配置必须用 redis:// 协议而非 tcp://
ThinkPHP 6+ 的 Session Redis 驱动默认只识别 redis:// 开头的 DSN，填 tcp://127.0.0.1:6379 会导致连接失败且无明确报错，日志里只显示 session_start(): Failed to initialize storage module。
实操建议：
- 在
config/session.php中，store_config的host、port等字段不用填，直接用dsn字段：'dsn' => 'redis://:password@192.168.1.100:6379/1'
- 密码含特殊字符（如
@、/）必须 URL 编码，否则解析失败；redis://user:p%40ss@...才对 - 多机部署时，所有服务器的
dsn必须指向同一个 Redis 实例或集群入口（比如 Redis Sentinel 的 VIP 或 Cluster 的任意节点）
Session key 前缀不统一会导致跨机读不到 session
默认情况下，ThinkPHP 会用 PHPSESSID + 当前域名生成 Redis key，但如果你在 Nginx 或负载均衡层做了域名改写（比如把 api.example.com 反向代理到 10.0.1.5），不同服务器可能生成不同前缀，结果就是 A 机器写入的 session，B 机器用另一个 key 去读，查不到。
实操建议：
- 强制指定全局 session key 前缀，在
config/session.php加：'prefix' => 'tp6_session:'
- 确保所有服务器的
session.name配置一致（检查php.ini或运行时ini_set('session.name', 'PHPSESSID')） - 别依赖
$_SERVER['HTTP_HOST']自动生成前缀——它不可控，尤其在容器或云 LB 环境下
session.gc_maxlifetime 和 Redis 过期时间必须严格对齐
ThinkPHP 的 Redis Session 驱动不会主动调用 EXPIRE，而是靠 Redis 自身 TTL。但如果 PHP 的 session.gc_maxlifetime 设为 1440（24 分钟），而 Redis 写入时没设 TTL，或者设得比它短，就会出现“用户还在操作，session 却没了”的问题。
实操建议：
- 在
config/session.php显式设置：'expire' => 1440
，这会控制 Redis 的SETEX或EXPIRE行为 - 同时确认
php.ini中session.gc_maxlifetime = 1440，两者必须相等，差 1 秒都可能触发提前清理 - Redis 服务端禁用
maxmemory-policy noeviction，否则内存满时会拒绝SETEX，导致 session 写入静默失败
Redis 连接超时和重试逻辑很弱，线上必须加健康检查
ThinkPHP 的原生 Redis Session 驱动没有连接池、无自动重连、超时后直接抛 RedisException 并终止请求，前端表现为 500 错误。而 Redis 短暂抖动（比如主从切换）在分布式环境很常见。
实操建议：
- 在
store_config中加上超时参数：'timeout' => 2.5, 'read_timeout' => 2.5, 'retry_interval' => 100
- 用
redis-cli -h x.x.x.x -p 6379 ping定期探测，失败时触发告警，别等用户投诉才发现 Redis 挂了 - 如果 Redis 是哨兵模式，DSN 必须用
redis://+ 哨兵地址，并启用sentinel配置项（TP6.3+ 支持，老版本需手动扩展驱动）
跨机 Session 共享真正卡点不在 Redis 本身，而在配置细节是否全链路一致：DSN 格式、key 前缀、TTL 设置、超时参数，漏一个，session 就变成单机孤岛。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
