composer请求缓存失效主因是动态参数（如_t时间戳）导致key不一致，且上游cache-control=no-cache干扰；应剥离无关参数构造稳定proxy_cache_key，忽略干扰响应头，配置proxy_cache_valid统一有效期，并针对404等状态设缓存兜底。
为什么 proxy_cache 对 Composer 请求经常失效
因为 Composer 的请求带大量动态查询参数（如 package.json?_t=1712345678），Nginx 默认不把 query string 纳入缓存 key，导致相同包请求被当成不同资源反复回源。更麻烦的是，packagist.org 返回的 Cache-Control 通常为 no-cache 或 max-age=0，直接启用 proxy_cache_use_stale 也不生效——Nginx 默认忽略这类响应头。
解决思路不是“覆盖上游头”，而是主动构造稳定缓存键 + 强制缓存策略：
- 用
proxy_cache_key显式拼接$scheme$host$request_uri，但剥离所有时间戳类参数（如_t、h） - 用
proxy_ignore_headers Cache-Control Expires Set-Cookie关掉上游干扰 - 用
proxy_cache_valid 200 302 1h统一设定有效时间，对404也缓存 10m（避免频繁探测不存在包）
如何让 composer install 请求命中缓存而不跳过代理
Composer CLI 默认使用 https://repo.packagist.org，但会发送 User-Agent: Composer/2.x 并附带 Accept: application/vnd.composer.repository+json。如果 Nginx 没匹配到这些特征，就可能被直连或返回 403。
关键配置点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
location ~ ^/packages\.json$和location ~ ^/p/.*\.json$块中，必须显式允许application/vnd.composer.repository+json的Accept头，否则 Nginx 可能拒绝转发 - 加
proxy_set_header Accept "application/vnd.composer.repository+json";，确保后端收到标准头 - 禁止透传
Authorization头（私有包场景除外），否则 Nginx 可能因头过大触发413 Request Entity Too Large
proxy_cache_lock 在高并发安装时的真实行为
开启 proxy_cache_lock on 后，首个未命中缓存的请求会锁住 key，后续相同请求排队等待而非并发回源。这对 Composer 场景很关键：多个容器同时 composer install 同一个包，只会有一次真实回源。
但要注意：
- 锁超时由
proxy_cache_lock_timeout控制，默认 5s；若后端响应慢（如网络抖动），超时后其他请求会各自发起回源，失去锁意义 - 锁只作用于「完全相同的缓存 key」，所以前面提到的 query string 归一化必须到位，否则
?_t=123和?_t=456被视为两个 key，锁无效 - 不要和
proxy_cache_background_update同时开——后者会在缓存快过期时静默刷新，但锁机制会阻塞该刷新请求，造成缓存长期 stale
回源失败时如何返回已缓存旧版本而非报错
Composer 安装过程容忍短暂不可用，但遇到 502/504 直接中断。用 proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504 可兜底，但需配合两个细节：
-
updating参数必须开启，否则后台更新缓存时，前端请求仍可能拿到过期内容而无感知 - 加
proxy_cache_background_update on，让 Nginx 在返回旧缓存的同时异步刷新，避免用户卡住 - 务必设置
proxy_cache_valid 404 10m，否则包不存在时反复回源，拖慢整个流程
缓存路径里别用 $host 当目录名——多个镜像域名共用同一缓存区时，key 冲突会导致 A 域名缓存污染 B 域名响应。统一用固定名称如 composer_cache 更稳妥。
