ThinkPHP 5.1 验证码校验失败的根源是 Session 驱动不匹配、存储路径权限不足、缓存残留及前端校验误触发 reset；需检查 session.type 配置与扩展启用状态，显式设置可写绝对路径，执行 php think clear --all 清空全部缓存与 session 文件，并禁用或分离验证码 reset 逻辑。
ThinkPHP 5.1 升级后验证码反复提示“错误”，明明输入正确却校验失败，session 中的 verify_code 值为空或不匹配，后台 dump(session('verify')) 返回 null，问题根源常藏在 Session 存储引擎切换与缓存残留的叠加影响中。
确认当前 Session 驱动类型是否变更
升级过程中 config/session.php 可能被覆盖或未同步更新，导致驱动从 file 切换为 redis 或 memcache，但实际服务未启用对应扩展，Session 写入静默失败。【驱动不匹配时，session_start() 不报错，但 set 操作完全失效】
打开 application/config.php 或单独的 config/session.php（若存在），检查 'type' 配置项：
若值为 'redis' 或 'memcache'，请立即验证 PHP 是否已安装并启用对应扩展：运行 php -m | grep redis，无输出则需先配置 Redis 扩展；若值为 '' 或 'file'，继续下一步。
立即学习“PHP免费学习笔记（深入）”；
重置 Session 存储路径并确保可写
升级后 TEMP_PATH 或 runtime 目录权限可能重置，尤其在 Linux 服务器上，web 用户（如 www-data）对 session.save_path 无写入权限会导致 session 文件无法生成。
第一步：定位当前 session.path 配置位置——优先检查 application/config.php 中 'session' => ['path' => ...]，其次查看 php.ini 的 session.save_path 值。
第二步：将 path 显式设为绝对路径，例如：'path' => '/var/www/your-project/runtime/session/'（注意末尾斜杠）。
第三步：执行命令修复目录权限：sudo chown -R www-data:www-data /var/www/your-project/runtime/session/ && sudo chmod -R 755 /var/www/your-project/runtime/session/。这一步不可跳过，否则即使路径正确，session 文件仍创建失败。
清空全部缓存与 Session 物理文件
Cache::clear() 只清内存键名，不删磁盘文件；而验证码依赖的 session 文件和模板缓存若残留旧版本结构，会干扰新框架的读取逻辑。
方法一：命令行强制清除（推荐）
进入项目根目录，执行：php think clear --all。该命令自 TP5.1.14 起支持，会真实删除 runtime/cache/、runtime/session/、runtime/log/ 全部内容。
方法二：手动清理（适用于无 CLI 权限环境）
直接删除 runtime 目录下三个子文件夹：cache、session、temp。注意不要删掉 route 或 html（如有），否则路由缓存丢失需重新生成。
【切勿只删 cache/ 下部分子目录——File 驱动按哈希分层存储，漏删会导致缓存残留】
验证验证码流程是否绕过 reset 机制
前端若在提交前调用 /captcha/check 接口做实时校验，会触发原始 check() 方法中的 $this->reset && session($key, null)，导致后续表单提交时 session 已空。
方法一：禁用自动 reset（快速验证）
在验证码配置数组中加入 'reset' => false，例如：
$config = ['reset' => false, 'expire' => 1800]; $captcha = new \think\captcha\Captcha($config);
方法二：分离校验逻辑（生产推荐）
为前端校验新建专用接口，内部调用自定义方法（不执行 session 清除），仅在最终表单提交时走原 check() 流程。这避免了 session 提前销毁。
