Flash数据丢失的根本原因是未满足读取时机、会话持久化和重定向流程三条件：需setFlash后立即redirect并终止脚本，Flash一次性读取后即清除，且依赖正常启用的Session组件及正确服务器配置。
页面跳转后 setFlash() 数据丢失，核心原因是 Flash 数据未被正确读取或会话未正常写入。Yii2 的 Flash 机制依赖 session 的生命周期管理，不是“设了就一定能拿到”，必须满足读取时机、会话持久化和重定向流程三个条件。
确保 setFlash 后立即执行重定向且不中断流程
调用 setFlash() 后，必须通过 redirect() 触发 HTTP 302/307 跳转，并**在 redirect 后显式终止脚本执行**。否则后续代码可能干扰 session 写入：
- 错误写法：只写
redirect()，但没加Yii::$app->end()或返回语句 - 正确写法：
return $this->redirect(['site/index'])->send(); Yii::$app->end();或更简洁地return $this->redirect(['site/index']);（因为redirect()默认返回 Response 对象，控制器动作返回它即自动结束） - 关键点：控制器动作必须 返回 redirect 结果，不能只是调用；若手动调用
Yii::$app->response->redirect()，务必跟Yii::$app->end()
确认 Flash 数据在目标页面被正确读取一次
Flash 数据是“一次性”的：调用 getFlash('key') 会立即从 session 中移除该条目。常见误操作包括：
- 在布局文件（如
@app/views/layouts/main.php）中多次判断getFlash()，比如先检查是否存在再显示，又再次调用取值 —— 第二次调用返回 null - 在视图里用
if ($msg = Yii::$app->session->getFlash('success')) { echo $msg; }是安全的；但不要写成两个独立的getFlash()调用 - 调试时可用
var_dump(Yii::$app->session->hasFlash('success'))先确认是否存在，避免误判为空
检查会话组件是否启用且未被意外关闭
Flash 功能底层依赖 yii\web\Session 实例。以下情况会导致 Flash 失效：
- 应用配置中禁用了 session 组件（
'session' => false），或自定义了 session 类但未继承yii\web\Session - 在控制器中手动调用了
$session->close()或$session->destroy()，导致 Flash 数据来不及写入 - 使用了无 Cookie 的会话模式（如通过 URL 传 SID），而重定向后新请求未携带 SID，造成 session ID 断连
- 验证方式：在任意 action 中打印
Yii::$app->session->isActive，应为 true；若为 false，需在beforeAction()或全局行为中确保$session->open()
排除环境与部署干扰因素
某些服务器配置会让 Flash 表现异常：
- PHP 8.4+ 默认开启
session.use_strict_mode = 1，若客户端首次请求带无效 session ID，服务端会拒收并生成新 ID，导致上一个请求设的 Flash 丢失 —— 建议在php.ini或入口脚本中设为0 - HTTPS 站点却设置了
session.cookie_secure = false，或反之，导致 Cookie 不被浏览器发送 - 跨子域场景下未统一设置
session.cookie_domain = '.example.com'，使 Flash Cookie 无法在跳转后的子域页面读取
