美国服务器上的OpenResty静态资源缓存不生效,应检查哪些配置?
同一个 CSS 文件刷新几次仍然被完整下载,OpenResty 日志里反复出现 200,或者 CDN 面板显示持续回源,都可能被描述为“静态资源缓存不生效”。排查美国服务器上的这类问题,应先核对实际响应,再依次检查 CDN、命中的 server/location、响应头以及 proxy_cache 条件,而不是直接增加缓存时间或清空缓存目录。
最关键的判断是:资源由 OpenResty 从本地磁盘读取,还是经 proxy_pass 从应用服务获取?前者通常检查浏览器缓存头、文件路径和条件请求;后者还要检查服务端缓存区、缓存键、跳过条件及上游响应。美国服务器的位置会影响跨境访问延迟,但不会改变这些缓存配置的语义。

针对美国用户访问的网站、接口和静态资源服务,A5数据提供美国物理服务器租用,覆盖常规Xeon、AMD EPYC及多IP等产品系列,并配备NVMe存储与CN2 GIA等线路方案。不同硬件资源可承载OpenResty、应用上游和静态文件目录等部署形态,为缓存配置、源站回源及跨境业务提供相应的服务器与网络基础。
一、确认现象:究竟是哪一层没有命中
先区分三种“缓存”
| 缓存层 | 主要检查位置 | 可用的判断依据 |
|---|---|---|
| 浏览器缓存 | Cache-Control、Expires、ETag、Last-Modified | 浏览器显示内存/磁盘缓存,或条件请求返回 304 |
| CDN 缓存 | CDN 缓存规则、源站响应头、缓存键 | CDN 提供的缓存状态、源站访问日志 |
| OpenResty 反向代理缓存 | proxy_cache_path、proxy_cache、绕过及写入条件 | $upstream_cache_status 出现 MISS、HIT 等状态 |
open_file_cache 缓存的是文件描述符、文件信息等,并不等于浏览器缓存,也不是 proxy_cache 的替代品。仅启用它,不能据此判断客户端会停止下载资源。
同样,访问日志出现 200 并不必然代表缓存失败:200 可能来自服务端缓存;浏览器直接使用本地缓存时,源站甚至不会收到请求。
用普通 GET 获取响应,避免测试方式干扰
以下命令适用于安装了 curl 的 Linux 运维终端。域名和资源路径均为示例,实际操作时替换为一个确认存在的静态文件:
URL='https://static.example.com/assets/app.a1b2c3.css'
curl -sS -D /tmp/asset-public.headers \
-o /dev/null "$URL"
cat /tmp/asset-public.headers
先确认状态码、Content-Type,再查看缓存相关头。若返回 301,应检查跳转后的真实地址;若返回 404 或 HTML 页面,应先处理路径和路由,不能把它当成 CSS 的缓存结果。
初次验证不要添加随机查询参数,也不要发送请求头 Cache-Control: no-cache。浏览器开发者工具中的“禁用缓存”也应关闭,否则测试行为本身就在要求重新获取资源。
这里使用 GET 而不是只用 HEAD,是为了尽量贴近实际资源请求。curl 本身不会像浏览器一样自动保存并复用 HTTP 缓存,因此连续两次 curl 都返回 200,不能直接证明浏览器缓存失效。
二、从外向内:先分开 CDN 与美国源站
对比公网入口和源站响应
如果域名前面有 CDN,可使用 --resolve 将同一个域名定向到美国源站 IP,同时保留正确的 Host 和 TLS SNI:
curl -sS \
--resolve static.example.com:443:203.0.113.10 \
-D /tmp/asset-origin.headers \
-o /dev/null "$URL"
cat /tmp/asset-origin.headers
203.0.113.10 是文档示例地址,必须替换为实际源站地址。该操作仅适用于有权访问的源站;不要为了测试关闭证书校验或放开源站访问控制。若源站只允许 CDN 回源,应从授权运维网络或源站本机验证。
结果可按以下方式解释:
- 源站缓存头正常,公网入口不同:优先检查 CDN 是否覆盖响应头、是否绕过该路径,以及是否按 Cookie、查询参数等划分缓存。
- 源站和公网入口都缺少缓存头:继续检查 OpenResty 的配置和实际响应链路。
- 公网入口持续回源,但源站头正常:检查 CDN 的缓存规则、资源状态码、对象大小限制和 TTL,不能只改源站
expires。 - 直连源站失败:先确认 IP、监听端口、证书及访问限制,失败本身不能证明缓存配置有问题。
跨境 RTT 较高时,304 的等待时间也可能明显。它说明客户端复用了资源内容,但仍完成了一次网络验证;与完全不发请求的浏览器本地缓存不是同一种效果。
三、检查 OpenResty 实际加载了什么配置
确认运行实例,再查看完整配置
常见问题不是指令写错,而是修改了另一套 Nginx 配置,或 reload 没有成功。先检查进程:
ps -eo pid,args | grep '[n]ginx: master process'
根据进程、服务定义和安装信息确认二进制及启动参数。下面以 Bash 和常见 OpenResty 安装路径为例;若实际使用了 -p、-c,应把相同参数加入数组,后续检测与 reload 均保持一致:
NGINX_CMD=(/usr/local/openresty/nginx/sbin/nginx)
"${NGINX_CMD[@]}" -V 2>&1
umask 077
DUMP=$(mktemp /tmp/openresty-config.XXXXXX)
"${NGINX_CMD[@]}" -T > "$DUMP" 2>&1
grep -nE 'server_name|listen|location|root|alias|try_files|expires|add_header|proxy_cache|proxy_pass|header_filter_by_lua' "$DUMP"
-T 会测试并展开配置,便于查看 include 后的有效内容;它不会 reload。输出可能包含内部地址或敏感配置,不宜直接公开。
重点核对四个位置:
- 请求域名是否匹配预期
server_name,还是进入了默认虚拟主机。 - 静态路径是否命中预期
location。 try_files是否把不存在的文件转给应用入口,发生内部跳转。- 实际文件路径是否与
root、alias的映射一致。
例如,root /srv/www/site; 配合 /assets/app.css,对应的是 /srv/www/site/assets/app.css。alias 则是替换匹配到的路径前缀,不能照搬 root 的拼接方式。
排除 location 和响应头冲突
下面这种配置中,正则 location 可能接管 /assets/ 请求:
location /assets/ {
expires 7d;
}
location ~* \.(css|js)$ {
expires off;
}
普通前缀匹配后,OpenResty 仍可能继续检查正则;使用 ^~ 的前缀可以阻止后续正则竞争,但只能用于明确、独立的静态目录,不能未经评估就套到所有路径上,以免跳过原有访问控制。
响应头方面,应逐项检查:
expires off不会主动生成浏览器缓存时间;但它也不会删除应用已经返回的缓存头。expires会生成或调整Expires和Cache-Control,再用add_header添加同名字段可能形成重复响应头。- 在默认继承规则下,子级只要配置了自己的
add_header,就不再继承父级整组add_header。因此,在静态location中增加一个调试头,也可能让父级安全头消失。 header_filter_by_lua*可能在响应阶段修改或删除缓存头,不能只检查 Nginx 原生指令。no-cache表示复用前需要验证,不等于禁止存储;no-store才是明确要求不存储。
还要检查缓存头是否出现在实际状态码上。不要为了让错误响应也带上缓存头,盲目给长时间缓存规则加 always,否则可能把不该缓存的错误结果交给客户端或 CDN。
四、按结果分支修复,而不是同时改所有层
分支一:OpenResty 直接读取本地文件
若资源确实在本地磁盘,优先修正路径、匹配规则和浏览器缓存头。以下示例放在现有目标 server 中,适用于独立公开静态目录:
location ^~ /assets/ {
root /srv/www/site;
try_files $uri =404;
expires 7d;
etag on;
}
预期结果是:存在的文件返回对应内容,并带有 Expires、约为 604800 秒的 max-age;不存在的文件返回 404,不再落到应用首页。
缓存时长必须与发布方式对应。带内容哈希的文件可以使用较长有效期;始终叫 app.js、发布时直接覆盖的文件,应采用较短有效期或验证策略,否则缓存“生效”反而会造成旧版本持续使用。
如果响应仍带 no-store,应继续检查实际命中的位置、Lua 过滤器和其他头部配置,而不是叠加更多 Cache-Control。本地静态文件没有经过上游时,$upstream_cache_status 通常为空或在日志中显示为 -,这是正常结果。
分支二:静态资源来自应用上游
仅配置 expires,不代表 OpenResty 会把上游响应保存到磁盘。服务端缓存需要在 http 中声明缓存区,并在实际命中的代理位置启用。
下面是合并到现有配置的示例片段,不应作为完整主配置直接覆盖使用:
# http 上下文
proxy_cache_path /var/cache/openresty/assets
levels=1:2
keys_zone=assets_cache:20m
inactive=1h
max_size=2g;
map "$http_authorization$http_cookie" $skip_asset_cache {
"" 0;
default 1;
}
# 目标 server 内,仅适用于公开、非个性化资源
location /assets/ {
proxy_pass http://127.0.0.1:8080;
proxy_cache assets_cache;
proxy_cache_key "$scheme|$host|$request_uri";
proxy_cache_valid 200 10m;
proxy_cache_bypass $skip_asset_cache;
proxy_no_cache $skip_asset_cache;
}
这里保留查询参数作为缓存键的一部分,避免不同版本资源混用。示例对携带 Cookie 或 Authorization 的请求采取保守策略:不读取缓存,也不写入缓存。
proxy_cache_bypass 控制是否跳过读取,proxy_no_cache 控制是否不保存响应,两者不能互相替代。若业务资源实际与 Cookie 无关,应先确认其确实没有用户差异,再调整规则,不能为了提高命中率直接移除保护。
继续检查上游响应:
Set-Cookie、Cache-Control: private/no-cache/no-store等可能阻止缓存。X-Accel-Expires可直接影响服务端缓存有效期。Vary: *会阻止缓存;其他Vary字段可能让响应按请求头形成不同变体。proxy_cache_valid 200 10m不是强制覆盖上游缓存策略,也不等于浏览器一定缓存十分钟。
不要把 proxy_ignore_headers 当作通用修复手段。忽略这些约束前必须确认资源没有个性化内容,否则可能造成跨用户响应混用。
若错误日志出现缓存目录 Permission denied,应按实际 worker 用户、目录路径及 SELinux 策略处理。不要直接设置全目录 777,也不要通过关闭安全机制来掩盖问题。
用日志区分“没读取”和“没保存”
可在 http 中定义日志格式,再临时用于目标虚拟主机:
log_format cache_diag
'$time_iso8601 host=$host request="$request" status=$status '
'file="$request_filename" upstream="$upstream_addr" '
'cache="$upstream_cache_status" '
'cc="$sent_http_cache_control" rt=$request_time';
# 放入需要排查的 server
access_log /var/log/openresty/cache-diag.log cache_diag;
日志目录需提前确认存在且具备相应访问条件;修改日志配置同样需要检测和 reload。请求中可能含敏感查询参数,应限制日志访问及保留时间。
| 观察结果 | 优先判断 |
|---|---|
第一次 MISS,随后 HIT | 该缓存键已成功写入并被复用 |
持续 BYPASS | 检查请求携带的 Cookie、认证头及绕过变量 |
持续 MISS | 检查上游禁止缓存头、proxy_no_cache、缓存键变化和写入错误 |
出现 EXPIRED | 请求命中了已过期缓存,需要关注有效期和更新行为 |
缓存状态为 - | 可能是本地文件、未启用缓存的位置,或内部跳转后的其他处理链路 |
五、检测、回滚和复测形成闭环
修改前先备份真正要编辑的文件。以下路径仅为示例,须替换为已确认加载的配置文件:
CFG=/usr/local/openresty/nginx/conf/conf.d/static.conf
BACKUP="${CFG}.bak.$(date +%Y%m%d%H%M%S)"
cp -a -- "$CFG" "$BACKUP"
只修改必要指令,不覆盖整个主配置。备份文件不要放进会被通配 include 加载的位置;若配置使用宽泛的包含规则,应改为在独立备份目录保存。
完成修改后执行:
"${NGINX_CMD[@]}" -t &&
"${NGINX_CMD[@]}" -s reload
前提是该命令及启动参数指向正在运行的实例。检测失败时不要 reload;reload 返回后仍应检查错误日志,确认新配置已应用。若缓存头、安全头或路由发生异常,恢复备份文件,再检测并 reload。
复测顺序保持固定:
- 直连美国源站:确认状态码、资源内容类型和缓存头。
- 验证浏览器条件请求:将真实响应中的 ETag 原样用于请求,例如:
curl -sS -D - -o /dev/null \
-H 'If-None-Match: "替换为实际ETag"' \
"$URL"
对支持该验证的资源,未变化时预期返回 304。若走公网入口,结果可能由 CDN 生成;验证源站时应继续使用 --resolve。
- 验证代理缓存:对同一 URL 连续发送无 Cookie、无认证头的 GET,观察是否由
MISS转为HIT。第一次可能已经命中旧缓存,不应强求必须出现MISS。 - 恢复公网入口验证:确认 CDN 规则与源站策略一致,再检查浏览器普通加载是否减少请求。
修复后持续观察缓存命中状态、上游请求量、缓存写入错误及资源更新是否及时。不要默认通过清空整个缓存目录来验收;测试一个新版本文件路径,通常比全量清缓存风险更低。最终应同时确认两件事:该复用的内容确实被复用,该更新的内容也能按发布策略及时更新。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3971.html


