Laravel 8部署服务器后忘记密码验证提示不显示问题

这个现象本质是session闪存消息丢失：Laravel自带的密码重置逻辑，不管是输错邮箱的报错、还是发信成功的提示，都是在业务逻辑执行完成后，把提示内容存入一次性session闪存，再重定向回表单页读取展示的。邮件能正常发送说明业务逻辑本身跑通了，只是存提示消息的环节在服务器环境出了问题，按概率从高到低的原因如下：

• 目录权限配置错误
  Laravel默认file驱动的session、缓存、视图编译文件都存在storage/framework目录下，如果部署时只给了storage/logs目录权限，没给web运行用户（www-data/nginx等）对storage/framework/sessions、storage/framework/cache、storage/framework/views的读写权限，session写入直接失败，闪存消息自然无法保存，会出现逻辑执行完（邮件发出去）但重定向后无提示的情况。
• Session相关环境变量配置不匹配
  服务器.env文件的session配置和实际访问场景不匹配，导致浏览器不接收session cookie，重定向后无法读取之前存的提示：
  • SESSION_DOMAIN配置和实际访问域名不一致，比如配置了带www的域名但实际用裸域访问、或反过来
  • Cookie安全属性不匹配：HTTP站点误将SESSION_SECURE_COOKIE设为true时，浏览器会拒绝在非加密请求中传输session cookie；HTTPS站点如果Laravel没正确识别到请求协议，生成的cookie缺少secure标记，也可能被浏览器安全策略拦截
  • session驱动配置错误，比如配置了redis/database驱动但对应服务未启动、连接参数错误，导致session无法正常存储
• 反向代理/CDN跳转规则异常
  如果服务器前套了Nginx反向代理、CDN服务，配置的强制HTTPS、域名跳转规则有误，会导致POST请求处理完成后出现二次301/302跳转，跳转过程中丢失Set-Cookie响应头，session无法生效；另外如果没有在App\Http\Middleware\TrustProxies中间件配置信任代理，Laravel会误判请求协议为HTTP，生成的跳转地址、cookie属性和实际访问协议不匹配，也会导致session失效。
• FastCGI参数配置缺失
  Nginx的PHP FastCGI配置漏传HTTPS、SERVER_PORT参数时，Laravel无法正确识别当前请求的协议和端口，生成的cookie属性不符合浏览器安全规则，被浏览器拦截无法存储。

快速排查步骤 #

1. 先修复目录权限：执行chmod -R 755 storage，将storage目录属主修改为web运行用户，排除权限问题
2. 核对.env中session相关配置，确保和实际访问场景一致，SESSION_DOMAIN可暂时留空排除域名匹配问题
3. 打开浏览器开发者工具-网络面板，提交重置密码请求后查看响应跳转链路，如果存在超过1次301/302跳转，调整Nginx/CDN跳转规则，避免对POST请求做二次跳转；同时在TrustProxies中间件添加protected $proxies = '*';配置信任代理
4. 写临时测试路由验证session闪存是否正常：如果存入的测试闪存消息重定向后无法读取，可100%确定是session配置问题，和密码重置业务逻辑无关

内容的提问来源于stack exchange，提问作者Thanpuia