ThinkPHP 6.1 的 buildHtml() 默认先在 runtime/html/ 下生成临时 HTML 文件，再尝试复制到配置的 HTML_PATH 目录；若目标目录不可写或路径不存在，文件将滞留于 runtime/html/ 而不出现于 public/static/ 等配置路径。
ThinkPHP 6.1 的静态缓存文件（即通过 buildHtml() 生成的 HTML 页面）默认生成在 runtime/html/ 目录下，而不是你配置的 HTML_PATH 路径——这点容易误解，也是很多人找不到文件的根本原因。
为什么在 runtime/html 下，而不是 HTML_PATH？
虽然配置中设置了 'HTML_PATH' => app()->getPublicPath() . '/static/' 这类路径，但 buildHtml() 方法内部实际执行时：
- 先在
runtime/html/下生成临时 HTML 文件（这是 ThinkPHP 内部固定行为） - 再尝试将该文件复制或移动到
HTML_PATH指向的目标位置（如public/static/） - 但如果目标目录不可写、路径不存在，或未显式调用复制逻辑，文件就只留在
runtime/html/里
如何快速定位生成的 HTML 文件？
直接检查以下路径（以 Linux 服务器为例）：
-
runtime/html/—— 首要查找位置，90% 的情况文件在这里 -
public/static/或你自定义的HTML_PATH目录 —— 若复制成功，会出现在这里 - 注意：目录名区分大小写，
html是小写；runtime目录必须可写
怎么确保文件生成到想要的位置？
不要只依赖配置，主动控制生成路径更可靠：
立即学习“PHP免费学习笔记（深入）”；
- 调用
buildHtml()时传入完整子路径，例如：$this->buildHtml('article', 'news/2024/09/', '123');
这会在runtime/html/news/2024/09/123.html生成，同时尝试复制到HTML_PATH . 'news/2024/09/123.html' - 手动创建目标目录并赋权：
mkdir -p public/static/news/2024/09 && chmod 755 public/static/news/2024/09 - 确认
HTML_PATH配置值是绝对路径（推荐用app()->getPublicPath()拼接）
常见找不到文件的原因
排查顺序建议：
- 检查是否开启了调试模式（
app_debug => true）：开启时buildHtml()可能跳过生成或输出中断 - 控制器方法末尾是否只有
$this->fetch()？含exit、redirect()或模板报错会导致输出为空 - 运行命令行生成时（如
php think build:html article），注意 CLI 默认模块是app，若控制器在portal模块，需指定完整类名或调整入口 - 查看
runtime/log/下最新日志，搜索 “buildHtml” 或 “html” 关键词，看是否有权限或路径错误提示
