Nginx代理OSS时请求触发try_files fallback问题排查与解决

1. 为何请求/logo64.png会触发try_files？ #

Nginx的try_files指令默认检查本地服务器文件系统的文件是否存在，而非后端代理的OSS存储。当你访问/logo64.png时，Nginx先在本地查找该文件，找不到就触发try_files的兜底规则返回/index.html，完全不会去OSS验证文件是否存在。

另外，location /是兜底匹配规则，所有未被更精确location（比如/static/）匹配的请求都会进入这个块，/logo64.png没有对应的专属location，因此会走带try_files的逻辑。

2. 修复方案 #

结合React SPA的需求（静态文件正常访问，路由请求兜底返回index.html），推荐两种可靠修复方式：

方案一：拦截后端错误，404时返回index.html #

修改location /配置，去掉try_files，改用proxy_intercept_errors和error_page让Nginx先代理请求到OSS，仅当OSS返回404时才返回index.html：

location / {
    proxy_pass https://haiskynology-test-web.oss-cn-hangzhou.aliyuncs.com/com.haiskynology.lightningmoment.web/test/build/;
    proxy_set_header Host test-cdn.lightningmoment.com;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    proxy_intercept_errors on; # 开启拦截后端错误响应
    error_page 404 =200 /index.html; # 将404转为200并返回index.html
}

方案二：为静态文件配置专属location #

枚举常见静态文件后缀，单独配置代理规则，避免这些请求进入带try_files的兜底location：

# 匹配所有常见静态文件后缀
location ~* \.(png|jpg|jpeg|gif|ico|css|js|svg|woff|woff2)$ {
    proxy_pass https://haiskynology-test-web.oss-cn-hangzhou.aliyuncs.com/com.haiskynology.lightningmoment.web/test/build/;
    proxy_set_header Host test-cdn.lightningmoment.com;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

location / {
    proxy_pass https://haiskynology-test-web.oss-cn-hangzhou.aliyuncs.com/com.haiskynology.lightningmoment.web/test/build/;
    proxy_set_header Host test-cdn.lightningmoment.com;
    try_files $uri $uri/ /index.html;
}

3. 调试步骤 #

• 开启Nginx debug日志：在nginx.conf中添加error_log /var/log/nginx/debug.log debug;，重启Nginx后访问目标URL，查看日志中的请求匹配流程、文件检查过程及代理行为，定位具体触发逻辑。
• 用curl测试请求：执行curl -v https://test.lightningmoment.com/logo64.png，查看响应头和内容，确认返回的是图片还是index.html，同时验证请求是否被正确转发。
• 验证OSS访问：直接访问OSS上的文件URL，确认文件存在且能正常返回；同时查看OSS的访问日志，检查Nginx的请求是否到达OSS。
• 临时注释try_files：暂时注释location /里的try_files指令，重新加载配置后测试静态文件是否能正常代理，确认问题根源是try_files的本地检查逻辑。

内容的提问来源于stack exchange，提问作者Seaky Lone