ThinkPHP模板不刷新主因是HTML静态缓存拦截请求，需关闭'html_cache_on'；模板缓存不更新则因cache_expire>0或文件时间戳未变；动态模板路径导致缓存失效；还需检查opcache和Web服务器缓存。
ThinkPHP 模板缓存不刷新？先确认是不是 html 静态缓存在作怪
很多人改了模板文件，页面却没变，第一反应是“模板缓存没清”，但实际常被忽略的是：ThinkPHP 默认开启的静态资源缓存（html 缓存）会拦截请求，压根不走到模板编译逻辑。它和模板缓存（runtime/view/xxx.php）是两套机制。
检查方法：直接访问一个带参数的 URL（比如 /index/index?x=1），如果这次变了，而 /index/index 不变，基本就是 html 缓存生效了。
- 关闭位置在配置文件
config/app.php，设'html_cache_on' => false - 若只在开发环境禁用，可用条件判断：
'html_cache_on' => app()->isDebug() - 别只清
runtime/view/，记得也清runtime/html/目录
模板缓存本身不更新？重点看 template.cache_expire 和文件时间戳
ThinkPHP 的模板缓存是否重新编译，取决于两个条件：源模板文件修改时间是否晚于缓存文件，以及 template.cache_expire 是否为 0 或负数。只要这个值大于 0（比如默认的 60），即使模板改了，缓存也会强制沿用 60 秒——这在开发时非常反直觉。
- 开发阶段务必设
'template.cache_expire' => 0（注意是数字 0，不是字符串'0'） - 该配置在
config/template.php或通过Config::set('template.cache_expire', 0)动态覆盖 - Linux 下要注意文件系统时间精度（如 ext4 默认 1 秒），快速连续保存可能被判定为“未更新”；可加个
touch命令强制刷新时间戳
用了 fetch() 或 display() 却没走缓存？检查模板路径是否含变量或动态拼接
ThinkPHP 只对明确的模板路径（如 'index/index'）生成稳定缓存名。一旦路径里有变量、函数调用或点号以外的字符（比如 $name . '_edit' 或 get_template_name()），框架会跳过缓存编译，每次重新解析——看起来“没缓存”，其实是根本没生成。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
$this->fetch($module . '/edit')→ 缓存失效 - 正确做法：确保模板标识是字面量字符串，或用配置+映射表替代动态拼接
- 调试技巧：打开
template.debug并查看runtime/log/日志，搜索Template cache file看是否真有缓存写入
禁用所有缓存后仍不生效？查 opcache 和 Web 服务器层
PHP 的 opcache 会缓存已编译的 PHP 文件（包括 ThinkPHP 生成的 runtime/view/*.php），Nginx/Apache 也可能返回 304 或本地强缓存。这时候清 runtime/ 根本没用。
- 临时禁用
opcache：在php.ini中设opcache.enable=0，或重启 PHP-FPM - 浏览器端按
Ctrl+F5强制刷新，检查响应头是否有Cache-Control: no-cache - Web 服务器配置中确认没有对
.html或/static/路径做过度缓存
真正卡住的地方往往不在 ThinkPHP 配置里，而在 PHP 运行时或 HTTP 链路上。动不动就删 runtime 目录，不如先看日志、抓响应头、关 opcache —— 缓存链越长，漏掉一层就越难定位。
