ViewAction 是 Yii2 用于动态渲染数据库模型内容的动作类，不生成静态 HTML 文件；需自定义 findModel 或 dataFilter 支持 slug 路由，否则易 404 或白屏；生成真实静态文件须手动调用 renderFile + file_put_contents 并配置 Web 服务器兜底规则。
ViewAction 是什么？它根本不渲染静态页面
ViewAction 是 Yii2 提供的一个内置动作类，专用于渲染 数据库中存储的模型内容（比如 Page 模型），不是用来生成或读取磁盘上的 HTML 文件。很多人搜 “Yii2 ViewAction 静态页面”，其实是混淆了「内容静态化」和「文件静态化」两个概念。它的工作流是：路由匹配 → ViewAction 实例化 → 调用 $model->getViewFile() 或直接 render() → 输出动态渲染结果。它压根不碰 file_put_contents、不写 .html 文件、也不依赖 Web 服务器是否命中物理文件。
为什么你用了 ViewAction 却还是 404？
常见错误是没配对模型查找逻辑和路由规则。比如你定义了 Page::findBySlug($slug)，但在 ViewAction 中没传入正确的 modelClass 或 dataFilter，导致查不到模型后直接返回空响应，而不是抛出 NotFoundHttpException。
-
ViewAction默认只查主键（id），你要渲染/about这种 slug 路由，必须显式覆盖findModel()方法，或配置'dataFilter' => ['slug' => $this->id] - 如果
Page::findBySlug('about')返回null，而你的ViewAction又没做判空处理，视图里访问$model->title就会触发 PHP Notice，环境若屏蔽错误，页面就白屏 - 别忘了在控制器里设
public $defaultAction = 'view'，否则SiteController::actionPage()这类自定义方法不会自动代理给ViewAction
想真正生成 .html 静态文件？别靠 ViewAction
要落地 HTML 文件，得用命令行脚本或 afterAction() 钩子，手动调用 Yii::$app->view->renderFile() 再写入磁盘。例如：
$html = Yii::$app->view->renderFile('@app/views/site/page.php', ['model' => $page]);
file_put_contents(Yii::getAlias('@webroot') . '/about.html', $html);
注意三点：
- 路径必须和 URL 美化规则一致 —— 如果路由是
'<slug:>' => 'site/page'，那生成的文件就得放在@webroot/about.html，不能是@webroot/pages/about.html - Web 服务器（Nginx/Apache）必须有兜底规则：先检查
REQUEST_FILENAME是否为真实文件，是则直接返回，否则才转发给index.php；缺了这句，静态文件永远不生效 -
renderFile()不自动加载 layout，你要复用 layout，得自己把$content塞进 layout 变量再 render，或者改用render()+ 临时切换$this->layout = false
最容易被忽略的点：缓存与更新一致性
静态文件一旦生成，除非你主动删除或重写，否则用户永远看到旧内容。但 ViewAction 是实时查库的 —— 这意味着你可能同时维护两套内容源：数据库一条记录，磁盘一个 HTML 文件。上线后改了数据库却忘了 regen 静态页，SEO 就崩了。更隐蔽的是：开发时开了 debug 模式，urlManager 缓存没清，改了路由规则但 ViewAction 还走老路径，连调试都找不到问题在哪。
