生产环境切Session驱动需避开GC卡死、连接失败、数据丢失三类事故：file驱动不抗并发，必须换redis或database；改SESSION_DRIVER后须清缓存、查硬编码、核对连接名；redis连不上要查scheme、密码配置及扩展版本；lifetime与expire_on_close组合易致闪退；子域名需设domain参数；残留session文件和中间件顺序亦是高频坑点。

直接换驱动不是改个配置就完事，关键得避开 GC 卡死、连接失败、数据丢失这三类高频事故。生产环境用 file 驱动扛不住并发，必须切 redis 或 database，否则 CPU 突然飙高八成是它在作祟。

SESSION_DRIVER 改了但没生效？检查 .env 和 config 缓存冲突

很多人改完 .env 里的 SESSION_DRIVER=redis 就以为搞定了，结果请求里还是走 FileSessionHandler。根本原因是 Laravel 会优先读取缓存后的配置，而不是实时解析 .env。

• 先运行 php artisan config:clear 清掉 bootstrap/cache/config.php
• 确认 config/session.php 中的 driver 没被硬编码覆盖（比如写死成 'driver' => 'file'）
• 检查 config/session.php 里 connection 是否匹配 config/database.php 中定义的 Redis 连接名（默认是 default）
• 如果用的是 Docker 或多环境部署，确保 .env 文件被正确挂载且权限可读

Redis 驱动连不上？别只看 host 和 port

报错 Connection refused 或 Redis server went away 不一定是网络不通，更可能是连接池或序列化配置不一致。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• config/database.php 里 Redis 的 scheme 要和实际部署一致：本地用 tcp，Docker 或云 Redis 常用 redis（如 redis://redis:6379）
• 检查 config/session.php 的 connection 值是否拼写错误，比如写成 'redis'（这是连接名）而非 'default'（默认连接名）
• 若 Redis 启用了密码，必须在 config/database.php 的 redis.default.password 里填，不能只靠 REDIS_PASSWORD 环境变量——Laravel 不自动注入这个字段
• PHP Redis 扩展版本太低（如 phpredis serialize 选项不兼容，建议显式设 'options' => ['serializer' => \Redis::SERIALIZER_PHP]

Session 数据突然“消失”？留意 lifetime 和 expire_on_close 组合陷阱

用户登录后刷新页面就登出，或者闪存消息（flash()）不显示，大概率是生命周期配置打架。

• expire_on_close => true 时，lifetime 完全失效，浏览器一关 Session 就销毁——这对管理后台很危险，容易误登出
• lifetime 单位是“分钟”，但 Redis 的 TTL 是秒级，Laravel 会自动乘 60；如果手动用 redis-cli 查 key，看到的过期时间是秒值，别误判为配置没生效
• 使用 redis 驱动时，gc_probability（垃圾回收概率）被忽略，Redis 自带过期淘汰机制，所以不用管 session.gc_maxlifetime 这类 PHP ini 设置
• 若前端用了多个子域名（如 app.example.com 和 admin.example.com），必须在 config/session.php 中设 'domain' => '.example.com'，否则 Cookie 不共享

从 file 切到 redis 后 CPU 还高？查 Session 目录残留和中间件顺序

换了驱动不代表旧文件自动消失，残留的上万 Session 文件仍可能被某些脚本或监控工具反复扫描，继续拖慢 I/O。

• 手动清空 storage/framework/sessions/ 目录（执行前确认已切到新驱动且服务正常）
• 检查是否有自定义中间件在 StartSession 之前就访问了 $request->session()，这会导致 Session 提前启动失败，回退到 array 驱动（内存中，不持久）
• 确认 app/Http/Kernel.php 中 \Illuminate\Session\Middleware\StartSession::class 在中间件栈里位置合理，不能被 EncryptCookies 之后的中间件干扰
• 如果用了 Horizon 或队列监听器，它们默认不加载 Session 中间件，session() 辅助函数在队列任务里返回空——这不是 bug，是设计使然

最常被忽略的一点：Redis 驱动下，session()->all() 或大量 put() 操作本身不慢，但如果你在 Session 里存了整个 Eloquent 模型对象（没用 toArray() 或 json_encode() 处理），反序列化时可能触发自动加载或数据库查询，CPU 就又上去了。