Nginx 中用 alias 配合 try_files 实现 SPA 子路径路由，关键在于 alias 定义 /admin/ → /var/www/myapp/ 的前缀替换映射，try_files 兜底必须写 /admin/index.html 才能正确映射到物理路径，避免 root 方式导致的根目录错位问题。
在 Nginx 中用 alias 配合 try_files 实现 SPA 路由转发，核心是让子路径（如 /admin/）下的所有前端路由请求，最终都落到该子路径对应的 index.html 上，同时不干扰真实静态文件访问。关键不在“转发”，而在“精准兜底”——alias 定义物理路径映射，try_files 决定找不到资源时回退到谁。
为什么不能直接用 root + /index.html？
当应用部署在子路径（比如 https://example.com/admin/）时，如果仍用 root 和 /index.html：
-
root /var/www/myapp;+try_files $uri $uri/ /index.html;会尝试从站点根目录找/index.html，而非/admin/index.html - 用户访问
/admin/dashboard，Nginx 查找/var/www/myapp/admin/dashboard（不存在）→ 回退到/var/www/myapp/index.html（路径错位，可能 404 或加载错误 JS）
alias 的正确写法与路径拼接逻辑
alias 不是别名，而是“前缀替换”：它把匹配的 location 路径完全移除，再把剩余 URI 拼到指定目录后。因此必须严格对齐斜杠：
-
location /admin/ { alias /var/www/myapp/; }→ 请求/admin/js/app.js映射为/var/www/myapp/js/app.js - 若写成
location /admin（无尾斜杠），/adminjs/app.js会被错误拼成/var/www/myappjs/app.js（缺斜杠，路径断裂） -
alias目录末尾不加斜杠也容易出错，推荐统一写/var/www/myapp/
try_files 在 alias 块中的兜底路径怎么写？
在 alias 块里，try_files 的最后一个参数（兜底项）不是相对于文件系统，而是相对于 当前 location 的 URI 空间。所以必须带子路径前缀：
- ✅ 正确：
try_files $uri $uri/ /admin/index.html; - ❌ 错误：
try_files $uri $uri/ /index.html;（会去根路径找，不是子应用的入口） - Nginx 内部会把
/admin/index.html映射为/var/www/myapp/index.html，因为alias已定义了/admin/ → /var/www/myapp/
完整配置示例（含静态资源与 API 隔离）
以下是一个生产可用的子路径 SPA 配置片段：
location /admin/ {alias /var/www/myapp/;
try_files $uri $uri/ /admin/index.html;
}
location /admin/api/ {
proxy_pass https://backend-server/;
}
location ~* ^/admin/\.(js|css|png|jpg|gif|svg|woff2?|ttf|eot)$ {
alias /var/www/myapp/;
expires 1y;
add_header Cache-Control "public, immutable";
}
- API 请求走独立
location /admin/api/，避免被try_files拦截 - 静态资源正则规则也加
/admin/前缀，并复用相同alias，确保路径一致 - 所有未命中静态文件或 API 的请求（如
/admin/settings），都由/admin/index.html接管
