美国服务器上的OpenResty静态资源缓存不生效,应检查哪些配置?

发布人:A5数据发布时间:2026-10-16 09:43阅读量:127

同一个 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。输出可能包含内部地址或敏感配置,不宜直接公开。

重点核对四个位置:

  1. 请求域名是否匹配预期 server_name,还是进入了默认虚拟主机。
  2. 静态路径是否命中预期 location。
  3. try_files 是否把不存在的文件转给应用入口,发生内部跳转。
  4. 实际文件路径是否与 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。

复测顺序保持固定:

  1. 直连美国源站:确认状态码、资源内容类型和缓存头。
  2. 验证浏览器条件请求:将真实响应中的 ETag 原样用于请求,例如:
   curl -sS -D - -o /dev/null \
     -H 'If-None-Match: "替换为实际ETag"' \
     "$URL"

对支持该验证的资源,未变化时预期返回 304。若走公网入口,结果可能由 CDN 生成;验证源站时应继续使用 --resolve。

  1. 验证代理缓存:对同一 URL 连续发送无 Cookie、无认证头的 GET,观察是否由 MISS 转为 HIT。第一次可能已经命中旧缓存,不应强求必须出现 MISS。
  2. 恢复公网入口验证:确认 CDN 规则与源站策略一致,再检查浏览器普通加载是否减少请求。

修复后持续观察缓存命中状态、上游请求量、缓存写入错误及资源更新是否及时。不要默认通过清空整个缓存目录来验收;测试一个新版本文件路径,通常比全量清缓存风险更低。最终应同时确认两件事:该复用的内容确实被复用,该更新的内容也能按发布策略及时更新。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3971.html

相关推荐