单页面应用使用History模式时，Nginx需配置try_files实现前端路由回退：根部署用location / { try_files $uri $uri/ /index.html; }，子路径部署需配合alias和base设置，并分离API与静态资源代理。
单页面应用（SPA）用 History 模式时，用户访问 /user/profile 或刷新页面，Nginx 默认会尝试找对应物理路径的文件，但实际所有路由都由前端 JS 控制。必须让 Nginx 在找不到真实文件时，始终返回 index.html，由前端接管路由。配置核心是 try_files，不是 rewrite。
基础配置：根路径部署
项目部署在域名根目录（如 https://example.com/），只需一个 location 块：
location / { try_files $uri $uri/ /index.html; }-
$uri先检查是否存在同名文件（如/logo.png） -
$uri/再检查是否为目录（如/docs/） - 都不存在时，内部重定向到
/index.html，不改变浏览器地址栏
子路径部署：带前缀如 /app/
项目实际访问地址是 https://example.com/app/，需两步配合：
- Nginx 中 location 匹配带前缀：
location /app/ { alias /var/www/my-spa/; try_files $uri $uri/ /app/index.html; } - 前端构建时设置
base: "/app/"（Vue）或homepage: "/app"（React），确保资源路径（如/app/static/js/app.js）能正确加载 - 注意：
alias结尾有斜杠，root没有；try_files最后一项写/app/index.html，不是/index.html
API 接口与静态资源分离
避免所有请求都落到 SPA 回退逻辑里，要明确区分：
- API 请求走反向代理：
location /api/ { proxy_pass http://backend; proxy_set_header Host $host; } - 静态资源（js/css/img）通常由同一目录提供，
try_files已覆盖；若资源放在 CDN 或独立路径，可加专属 location，如location /static/ { expires 1y; add_header Cache-Control "public, immutable"; } - 图标、robots.txt 等可单独处理：
location = /favicon.ico { log_not_found off; return 204; }
别用 rewrite 替代 try_files
rewrite 是重写 URL 并可能触发外部跳转，容易破坏 history 路由：
- 错误示例：
rewrite ^(.*)$ /index.html last;—— 可能导致无限重定向或丢失 query 参数 - 正确做法始终优先用
try_files，它是专为 SPA 设计的内部回退机制 - 只有极少数场景需
rewrite，比如强制去除 trailing slash 或统一跳转 HTTPS，但和路由回退无关
