NGINX配置问题：为多版本单页应用子路由提供静态文件

你的V2 SPA需要支持真实子路由（比如/v2/members、/v2/tasks/123），核心是让NGINX在找不到对应静态文件时，把所有/v2开头的请求都转发到V2的index.html，由前端路由来处理路径。

修正后的NGINX配置 #

# 处理V2的所有子路由请求
location /v2 {
    auth_request /auth;
    # 指定V2静态文件的根目录
    root /frontendv2/app;
    index index.html;
    # 核心规则：先尝试匹配静态文件/目录，不存在则回落到V2的index.html
    try_files $uri $uri/ /v2/index.html;
}

# V1锚点路由的配置（无需修改，保持原样即可）
location / {
    auth_request /auth;
    root /frontend/app;
    index index.html;
    # 可选：给V1也加上try_files，防止意外的路径请求返回404
    try_files $uri $uri/ /index.html;
}

配置说明 #

• root /frontendv2/app：告诉NGINX，/v2路径下的请求对应的静态文件都来自/frontendv2/app目录。比如请求/v2/main.js时，NGINX会去查找/frontendv2/app/main.js。
• try_files $uri $uri/ /v2/index.html：
  • 首先尝试访问请求路径对应的静态文件（$uri）
  • 如果是目录，尝试访问目录下的index.html（$uri/）
  • 如果以上都不存在，就返回/v2/index.html（对应物理路径/frontendv2/app/index.html），让前端路由解析当前URL的路径并渲染对应的页面。
• 原来的try_files '' /frontendv2/app/index.html写法不够规范，而且没有利用NGINX的路径解析能力，换成标准的try_files规则能更可靠地处理所有子路由场景。

注意事项 #

• 确保/frontendv2/app目录下存在index.html以及V2的所有静态资源（JS、CSS、图片等）
• 认证逻辑auth_request /auth保持不变，不影响路由处理
• 不管V2的路由嵌套多深（比如/v2/tasks/123/details），这个配置都能正确回落到index.html，由前端路由处理

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