ThinkPHP 5.1 开启静态缓存后图片不显示，主因是生成的静态HTML文件物理位置改变导致相对路径失效，应统一使用以/开头的根目录绝对路径（如<img src="/images/logo.png">），并确保图片存放于public目录下、静态HTML不置于runtime等被服务器禁止访问的路径中。
ThinkPHP 5.1 开启静态缓存（HTML_CACHE_ON）后图片不显示，问题通常不在缓存本身，而在于静态缓存机制改变了资源加载上下文——生成的 HTML 文件被固化为纯静态页面，其中的图片路径若依赖动态逻辑（如 URL 重写、入口目录偏移、或相对路径计算错误），就极易失效。
检查静态 HTML 中图片 src 是否真实可访问
静态缓存会把整个页面（含 <img> 标签）原样保存为 .html 文件。关键要确认：这个生成后的 HTML 文件里，src 属性指向的路径，在浏览器中是否真能打开？
- 右键页面 → “查看网页源代码”，找到
<img src="...">，复制该 URL 到新标签页打开 - 若返回 404，说明路径错了；若返回 403，可能是服务器禁止了该目录（如
runtime/下被误放） - 特别注意：静态缓存生成的 HTML 若放在
runtime/html/目录下，而图片仍在public/，那么src="images/logo.png"实际是相对于runtime/html/目录解析的，必然失败
确保图片路径使用网站根目录绝对路径
动态页面中可用相对路径，但静态缓存后，HTML 文件物理位置变了，相对路径基准失效。必须统一用以 / 开头的绝对路径：
- ✅ 正确：
<img src="/static/images/avatar.jpg">（从域名根开始找） - ❌ 危险：
<img src="images/avatar.jpg">或<img src="../public/images/avatar.jpg">（静态化后路径错乱） - 在模板中统一用
{:url('')} /static/...或直接写/static/...，避免拼接变量导致路径断裂
关闭静态缓存或排除图片所在页面
静态缓存本就不适合频繁变动或含动态资源（如用户头像、验证码、实时图表）的页面。更稳妥的做法是按需关闭：
立即学习“PHP免费学习笔记（深入）”；
- 全局关闭：
'HTML_CACHE_ON' => false（在config/app.php或app/config.php中设置） - 局部关闭：在对应控制器方法开头加
config('html_cache_on', false); - 或配置缓存规则，排除含图片的路由，例如：
'HTML_CACHE_RULES' => ['*.php' => false, 'index/index' => false]
验证 Web 服务器是否阻止了静态缓存目录的资源访问
有些 Nginx/Apache 配置会限制非 public/ 目录下的文件直出。如果静态 HTML 被生成在 runtime/html/，而里面引用了 /runtime/html/assets/icon.png 这类路径，服务器大概率会 403 拒绝。
- 检查 Nginx 配置中是否有类似
location ^~ /runtime/ { deny all; }的规则 - 确保所有图片资源只放在
public/及其子目录（如public/images/、public/static/）下，并通过/images/xxx访问 - 不要把生成的静态 HTML 文件放在 web 可访问路径之外，也不要让图片路径指向 runtime 目录
