ThinkPHP 的 buildHtml 方法生成页面为空，是因为控制器中存在 exit/die/redirect 或模板未定义变量触发错误导致输出缓冲中断；需确保仅执行 fetch()、关闭调试模式、检查模板路径与缓存目录权限。
ThinkPHP 的 buildHtml 方法为什么生成的页面总是空的
因为 buildHtml 本质是「运行一次控制器方法 + 捕获输出」，如果控制器里用了 exit、die、redirect()，或者模板中存在未定义变量导致 Notice 级错误（且错误报告开启），输出缓冲就会中断，结果为空。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保目标控制器方法最后是
$this->fetch()，且不带任何跳转或终止逻辑 - 临时关闭调试模式：
'app_debug' => false，避免错误信息混入 HTML - 检查模板路径是否正确，
buildHtml('index')对应的是index.html文件名，但读取的是index对应的模板（如index/index） - 确认缓存目录可写，尤其是
runtime/html/路径，ThinkPHP 会先生成到这儿再复制
静态页生成后不更新？buildHtml 的缓存机制怎么绕过
buildHtml 默认不会重复生成已存在的文件，它只在目标 HTML 文件不存在时才执行。这不是“缓存”，而是“懒生成”逻辑——你改了模板或数据，但旧 HTML 还在，访问的就永远是旧内容。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上线前加一步清理：
unlink(runtime_path() . 'html/index.html')再调用buildHtml - 更稳妥的做法：把生成逻辑封装进命令行指令（
php think build:html index），并在部署脚本中强制触发 - 别依赖浏览器刷新判断——静态页走的是 Web 服务器直出，和 PHP 缓存、ThinkPHP 模板缓存都无关
用 SaeRuntime::init() 或 Nginx 静态化时，buildHtml 生成的路径对不上
ThinkPHP 的 buildHtml 默认生成到 public/static/（或你配置的 html_path），但实际部署时，Web 服务器可能期望静态资源放在 public/ 根下，或子目录如 public/news/2024/01/。路径错位会导致 404。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 手动指定生成路径：
buildHtml('article', 'news/2024/01/', 'article')—— 第二个参数是子目录，第三个是文件名（不含扩展） - 生成前确保目录存在：
mkdir(public_path() . 'news/2024/01/', 0755, true) - Nginx 配置里别写死
location /static/，而要允许匹配真实 URL 路径，比如location ^~ /news/直接 serve 静态
为什么在 CLI 下运行 buildHtml 报错 “Module not exists”
CLI 环境默认走的是 app 模块，但你的静态页控制器可能在 home 或 portal 模块里。buildHtml('index') 会尝试加载 app\index\controller\Index，而不是你想要的 app\portal\controller\Article。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 显式传入完整模块/控制器/操作：
buildHtml('article/read', 'portal/article/', 'read') - 或在命令行中切换模块环境：
php think build:html --module=portal --controller=Article --action=read（需自定义指令） - 检查
config/app.php中的'default_module'，CLI 下它不会自动识别路由绑定的模块
