Nginx静态资源缓存优化关键在于合理配置Cache-Control头，需按资源类型区分设置public、max-age、immutable等指令，并通过add_header精准控制；推荐优先使用add_header而非expires，配合资源版本化（如哈希文件名）实现URL级缓存失效，兼顾强缓存性能与更新可靠性。
如果您在ThinkPHP项目中部署于Nginx环境，发现CSS、JS或图片等静态资源更新后用户仍加载旧版本，页面样式错乱或功能异常，则很可能是Nginx未对静态资源实施合理缓存策略，或缓存机制与ThinkPHP的资源发布方式不匹配。以下是针对该问题的多种优化方案：
一、配置Nginx本地代理缓存（适用于反向代理架构）
该方式在Nginx层建立独立缓存区，将静态资源响应持久化存储于磁盘，避免重复回源至PHP后端，显著降低应用服务器压力。适用于前端请求经Nginx代理至后端PHP服务（如90端口）的典型部署。
1、在nginx.conf的http块中添加缓存路径定义：
proxy_cache_path /var/cache/nginx/static_cache levels=1:2 keys_zone=static_cache:100m inactive=7d max_size=2g;
2、在server块内为静态资源location添加缓存指令：
location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ {
proxy_pass http://backend_php;
proxy_cache static_cache;
proxy_cache_valid 200 302 7d;
proxy_cache_valid 404 1m;
proxy_cache_use_stale error timeout updating http_500;
add_header X-Cache-Status $upstream_cache_status;
}
立即学习“PHP免费学习笔记（深入）”；
3、确保upstream已正确定义backend_php，指向实际运行ThinkPHP的PHP-FPM或FastCGI服务地址。
二、启用Nginx内置静态文件直接服务+强缓存头（推荐默认方案）
当静态资源统一存放于public/目录且无需经PHP处理时，应绕过PHP直接由Nginx响应，并通过expires或Cache-Control精确控制浏览器缓存行为。此方式零PHP开销、延迟最低，且与ThinkPHP资源版本策略天然兼容。
1、确认ThinkPHP的public目录为Nginx root，例如：root /var/www/myapp/public;
2、在server块中添加静态资源location块：
location ~* ^/(static|css|js|images|uploads)/.*\.(css|js|png|jpg|jpeg|gif|ico|webp|svg|woff2?|ttf|eot|otf|mp4|webm)$ {
expires 365d;
add_header Cache-Control "public, immutable";
add_header Last-Modified "";
add_header ETag "";
}
3、关键提示：必须配合资源URL版本化使用，否则365天缓存将导致更新不可见。
三、强制协商缓存并启用ETag校验（兼顾兼容性与即时性）
该方式不依赖强缓存时长，而是让浏览器每次发起条件请求（If-None-Match / If-Modified-Since），由Nginx根据文件真实修改时间或哈希生成ETag或Last-Modified头，服务端返回304响应复用本地缓存。适合无法修改构建流程、又需保障更新及时性的场景。
1、在http或server块中启用ETag：
etag on;
2、在静态资源location中启用协商缓存支持：
location ~* \.(css|js|png|jpg|gif|svg)$ {
add_header Cache-Control "no-cache, must-revalidate";
add_header Pragma "no-cache";
add_header Expires "0";
}
3、注意：此模式下Nginx必须能准确读取文件mtime，确保public目录下文件权限允许Nginx用户访问。
四、结合ThinkPHP资源版本化实现URL级缓存失效（工业级可靠方案）
从根本上规避浏览器缓存陈旧问题，原理是使每次资源内容变更均映射为全新URL，旧缓存自然失效。Nginx仅需按新URL提供服务，无需干预缓存逻辑，与前述任一Nginx缓存策略均可叠加使用。
1、在ThinkPHP模板中使用build_url或自定义助手函数注入哈希版本：
<link rel="stylesheet" href="/css/app_<?php echo md5_file(ROOT_PATH.'public/css/app.css'); ?>.css">
2、构建后生成形如/app.css → /app_d41d8cd98f00b204e9800998ecf8427e.css的带哈希文件名，并同步更新HTML引用。
3、Nginx配置中允许匹配下划线+哈希格式的静态路径：
location ~* ^/.*_[a-f0-9]{16,64}\.(css|js|png|jpg|gif)$ {
expires 10y;
add_header Cache-Control "public, immutable";
}
4、必须关闭Nginx对未命中文件的try_files回退到index.php，防止哈希文件404时被TP路由捕获。
五、禁用特定路径的缓存以保障动态资源实时性
ThinkPHP部分资源（如入口index.php、路由API、AJAX接口）必须禁止缓存，否则将导致路由错误或数据陈旧。需明确区分静态与动态资源路径，避免全局缓存指令误伤。
1、在server块顶部或通用location前，显式禁用PHP脚本缓存：
location ~ \.php$ {
fastcgi_pass php_backend;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0";
add_header Expires "0";
add_header Pragma "no-cache";
}
2、对ThinkPHP的runtime、log、cache等敏感目录添加拒绝访问规则：
location ^~ /runtime/ { deny all; }
location ^~ /log/ { deny all; }
3、严禁在location ~ \.php$块中设置expires或proxy_cache指令，否则将导致PHP响应被意外缓存。
