yii2 的 setflash() 必须配合重定向使用，本质是 session 中一次性键值对，仅下一次请求有效；若仅 render 不跳转则用户不可见，跳转后未用 hasflash() 判断则消息静默消失。
Yii2 中 setFlash() 必须配合重定向使用，否则页面刷新即丢失
Flash 消息本质是 session 里带一次性的 key-value，只在下一次请求中有效。如果只是 $this->render() 而不跳转，消息不会自动清空，但用户看不到——因为没触发新请求；如果跳转后没检查 hasFlash()，消息就静默消失了。
- ✅ 正确姿势：保存成功后调用
Yii::$app->getSession()->setFlash('success', '操作成功')，紧接着return $this->redirect(['index']) - ❌ 常见错误：在
actionCreate里设了 flash，却直接return $this->render('create')—— 页面没变，用户根本收不到提示 - ⚠️ 注意：flash 是基于 session 的，若 session 配置异常（如
session.use_cookies=off或跨域导致 cookie 不写入），消息会始终不显示
View 层必须显式判断 hasFlash() 并渲染，框架不自动输出
Yii 不会像 Laravel 那样自动把 flash 注入模板变量。你得自己在视图文件（比如 views/member/index.php）里写逻辑判断、取值、输出 HTML。
- 推荐用
yii\bootstrap\Alert组件快速渲染：use yii\bootstrap\Alert; if (Yii::$app->session->hasFlash('success')) { echo Alert::widget([ 'options' => ['class' => 'alert-success'], 'body' => Yii::$app->session->getFlash('success'), ]); } - 不用 Bootstrap？那就手写 HTML：
<?php if (Yii::$app->session->hasFlash('error')): ?> <div class="alert alert-danger">= Yii::$app->session->getFlash('error') ?></div> <?php endif; ?> - ⚠️ 容易漏：忘记在
getFlash()后加echo，或把判断写错位置（比如写在 layout 外、某个 widget 内部却没传参）
Yii1 和 Yii2 的 session/flash API 差异大，混用会报错
Yii1 用 Yii::app()->user->setFlash()，Yii2 改成 Yii::$app->session->setFlash()。两者底层机制不同，不能靠改命名就迁移。
- Yii1 的
setFlash()默认作用于CWebUser组件，而 Yii2 的 session 是独立组件，user不再管 flash - Yii2 中
Yii::$app->user->setFlash()是非法调用，会抛出Calling unknown method: yii\web\User::setFlash() - 如果你在升级项目，别抄老代码里的
Yii::app()->user->hasFlash()，一律换成Yii::$app->session->hasFlash()
自定义跳转提示页（如“操作成功，3秒后跳转…”）要手动控制流程
默认的 flash + redirect 是立即跳转，没有中间提示页。想实现带倒计时的提示页（类似 PHP 的 header("Refresh:3;url=xxx")），就得绕过自动 redirect，自己 render 一个中间页。
- 控制器里不调
redirect()，而是传参给视图：$this->render('show_message', [ 'msg' => '删除成功', 'jumpUrl' => ['index'], 'wait' => 3, ]); - 视图
show_message.php里用 meta 刷新或 JS：<meta http-equiv="refresh" content="<?= $wait ?>;url=<?= \yii\helpers\Url::to($jumpUrl) ?>">
- ⚠️ 关键点：这个页面不能依赖 flash（因为已过期），所有数据必须由控制器显式传入；否则提示文字为空、跳转链接 404
