ThinkPHP 6.0 Redis Session 读写失败主因是配置错误、驱动未加载、序列化不匹配、权限问题或版本兼容性，需分层排查：先验连接与配置，再查驱动是否生效，接着确认数据是否真实写入及解码正确，最后排除Cookie环境干扰。
ThinkPHP 6.0 的 Session 存 Redis 读写失败，不是“连不上 Redis”这么简单，而是常卡在配置、驱动、序列化、权限或版本兼容这几个关键环节。排查要分层推进，先确认连接通不通，再看数据写没写进去，最后查读取逻辑是否匹配。
一、确认 Redis 连接和基础配置是否生效
Session 要用 Redis，前提是框架能真正连上并操作它——但 TP6 不会复用 cache 的 Redis 配置，必须单独配 session.redis_config。
- 检查 config/app.php 中的 session 数组：必须包含
'type' => 'redis'和完整'redis_config' => ['hostname' => '127.0.0.1', 'hostport' => 6379, 'password' => null]（密码为空必须显式写null，不能留空字符串） - 运行
php think run后，在控制器里执行：dump(config('app.session.redis_config'));确保输出是你填的值，不是空数组或默认值 - 手动测试 Redis 连通性：
$redis = new \Redis(); $redis->connect('127.0.0.1', 6379); var_dump($redis->ping());—— 返回string(4) "PONG"才算通 - 如果用 Docker 或远程 Redis，别写
localhost；Redis 6+ 开了protected-mode yes且没设密码时，外部连接会被拒绝，临时可关掉或配好密码
二、验证驱动是否加载成功，有没有静默降级
TP6 的 Redis Session 驱动不是内置的，必须装扩展，否则哪怕配置全对，也会悄悄退回到 file 驱动，不报错也不警告。
- 执行
composer require topthink/think-session—— 这个包是必须的，缺了就降级 - 检查 PHP 是否启用了
redis扩展（不是predis）：php -m | grep redis应该输出redis - 在控制器中执行：
dump(session()->getHandler());
如果返回的是think\session\driver\File，说明驱动没加载成功，99% 是没装扩展或配置位置错了
三、检查写入是否真发生，还是“看似成功实则静默丢弃”
常见现象是 session('user_id', 123) 没报错，但下一次请求读出来是 null。这往往不是连接问题，而是数据根本没存进 Redis，或存了但读的时候解码失败。
立即学习“PHP免费学习笔记（深入）”；
- 用
redis-cli直连 Redis，执行：KEYS 'think_session_*'
看有没有键生成；如果有，再GET think_session_xxx查内容是不是你预期的序列化字符串 - 检查
config/session.php中的'prefix'：不能含空格、中文、特殊符号，非法前缀会导致键名拼错，GET 命令查不到 - 确认
'serialize'选项是false（默认值）。如果设为true，而 Redis 里存的是 JSON（比如从 TP5.1 迁移过来），TP6 尝试反序列化就会失败，返回空字符串 - 若 Redis 数据是 TP5.1 写入的 JSON 格式，需在 session 配置中加：
'serializer' => \think\session\serializer\PhpSerializer::class来兼容
四、排除环境与运行时干扰
有些问题只在特定场景暴露，比如跨域、HTTPS、CLI 或子域名切换时，Session Cookie 设置不对，导致 ID 传不过去，看起来像“读不到”，其实是压根没发来。
- 打开浏览器开发者工具 → Network → 刷一次页面 → 看响应头是否有
Set-Cookie: PHPSESSID=xxx；没有，说明 Session 没启动或 Cookie 被拦截 - 检查
session.cookie_secure：HTTPS 站点必须为true，否则浏览器不带 Cookie；HTTP 环境设为true就永远传不了 - 检查
session.cookie_domain：多子域（如 a.example.com / b.example.com）要用.example.com，注意开头那个点 - CLI 环境默认禁用 Session，不要在命令行里测 Web Session 行为
