ThinkPHP5.0 Redis Session失败的核心原因是驱动未接管、配置字段错位或phpredis扩展未就绪；须依次验证：扩展是否加载（php -m | grep redis）、config/session.php中type为小写'redis'且redis子数组含host/port/password/select/prefix（select为整数、password显式为空字符串）、排除Session::init()临时配置导致的配置覆盖，并用redis-cli keys sess:*实测键是否真实写入。
ThinkPHP5.0用Redis存Session失败，核心问题通常不在“会不会配”，而在于**驱动没真正接管、配置字段错位、或底层扩展未就绪**。只要按顺序把三件事做对，基本就能通——不是调参，是验证链路是否完整。
确认phpredis扩展已加载且版本兼容
TP5.0的Redis Session驱动依赖原生 phpredis 扩展（不支持Predis），且要求版本 ≥ 4.3.0。低版本会导致反序列化失败，写入成功但读取返回空。
- 终端执行：
php -m | grep redis，必须看到redis输出；无结果说明扩展未启用 - Windows用户：下载与PHP版本严格匹配的
php_redis.dll（注意TS/NTS、VC编译器、位数），放入ext/目录，并在php.ini中添加extension=php_redis.dll - Linux/macOS：用
pecl install redis或系统包管理器安装（如apt install php-redis），再确认php.ini启用 - 改完php.ini后必须重启PHP-FPM或Web服务器，再运行一次
php -m | grep redis验证
正确配置 config/session.php
TP5.0的Session配置集中在 config/session.php，不是 cache.php 或全局 config.php。常见错误是字段名写错、大小写不对、或漏掉 redis 子配置。
- 确保
'type' => 'redis'（小写，不能是Redis或REDIS） - 完整补全
'redis'数组，至少包含：host、port、password、select、prefix - 示例配置：
'type' => 'redis',
'redis' => [
'host' => '127.0.0.1',
'port' => 6379,
'password' => '',
'select' => 2,
'timeout' => 60,
'prefix' => 'sess:',
],
-
prefix必须是合法字符串（不能含空格、中文），否则Redis键名拼接失败，GET查不到 -
select必须为整数（如2），不能写成字符串"2" -
password即使为空也必须保留''，不能省略或设为null
排除驱动降级和临时配置干扰
TP5.0 Session类有个隐藏陷阱：如果在控制器里调用 Session::init(['expire'=>3600]) 这类临时配置，会**完全替换原始配置**，导致Redis连接参数丢失，自动回退到file驱动——此时写入的是文件，但你还在Redis里找key，当然找不到。
立即学习“PHP免费学习笔记（深入）”；
- 检查代码中是否在中间件、控制器或行为里调用了
Session::init() - 若必须动态设置，应手动合并配置：
Session::init(array_merge(Config::get('session'), ['expire'=>3600])) - 临时切到
'type'=>'cache'测试：若切换后Session恢复，基本可锁定是Redis驱动未生效，而非业务逻辑问题
快速验证Redis是否真实接管
别只看配置文件，要实测数据是否真进了Redis。
- 在控制器里执行：
session('test_key', 'tp5_session_ok');
dump(session('test_key'));
- 同时打开终端，用
redis-cli连上服务，执行：keys sess:*（注意前缀要和配置一致） - 若能看到类似
sess:abc123xyz的键，再get sess:abc123xyz看值是否为序列化后的字符串，说明写入成功 - 如果
keys无结果，但session()返回正常 → 驱动没注册，回头查扩展和type大小写 - 如果
keys有结果但get返回空或乱码 → 检查serialize是否误开启（TP5默认为false，开启需确保两端一致）
