alias不支持SPA history模式刷新，因它是路径替换而非拼接，导致try_files回退路径解析错位；应改用root+try_files，并确保磁盘路径与URL严格对齐。
alias 本身不支持自动处理前端 SPA 的 history 模式刷新，多级子目录下直接用 alias 映射整个应用目录并配 try_files，会因路径解析错位导致 404。核心解法是：**别用 alias 做整站路由回退，改用 root + try_files，并确保目录结构与 URL 路径严格对齐**。
为什么 alias 在多级子目录中无法解决刷新丢失
alias 是“替换”而非“拼接”。比如：
-
location /app/v2/ { alias /var/www/myapp/; } → 请求
/app/v2/about会被映射到/var/www/myapp/about - 但 try_files $uri $uri/ /app/v2/index.html 中的
/app/v2/index.html是相对全局 root 解析的，不是 alias 目录，所以回退失败 - 即使写成
/var/www/myapp/index.html，也只兜底单个文件，无法支持嵌套路由（如/app/v2/user/profile）
正确做法：用 root + try_files 对齐层级
前提是磁盘路径结构与 URL 路径一致。例如 URL /app/v2/user/settings 对应文件 /srv/web/app/v2/user/settings.html 或 /srv/web/app/v2/index.html：
- 配置 location 匹配前缀，root 指向父级目录
- try_files 先查具体路径，再查目录索引，最后 fallback 到 index.html
示例：
location /app/ {
root /srv/web;
try_files $uri $uri/ /app/index.html;
}
这样：/app/v2/dashboard → 查 /srv/web/app/v2/dashboard；不存在则查 /srv/web/app/v2/dashboard/；最后回退到 /srv/web/app/index.html（注意不是 /app/v2/index.html）
若需保留多版本目录（如 /app/v1/、/app/v2/）且各自独立
不能共用一个 root 回退，需分版本配置或用变量动态 root：
- 方案一：显式分段（适合版本固定）
location /app/v1/ {
root /srv/web;
try_files $uri $uri/ /app/v1/index.html;
}
location /app/v2/ {
root /srv/web;
try_files $uri $uri/ /app/v2/index.html;
}
- 方案二：用 map 提取版本号 + root 变量（适合版本较多）
map $uri $app_root {
~^/app/v1/(.*)$ /srv/web/v1;
~^/app/v2/(.*)$ /srv/web/v2;
default /srv/web/v1;
}
server {
location /app/ {
root $app_root;
try_files $uri $uri/ /index.html;
}
}
特别注意的坑
- alias 和正则 location（~ 或 ~*）一起用是未定义行为，Nginx 官方禁止，务必避免
- 所有 location 末尾斜杠必须和 alias/root 后路径斜杠一致（推荐统一加 /）
- 前端构建时 publicPath 或 base 必须设为对应路径，例如 Vue Router 的
base: '/app/v2/'，否则 JS 加载的资源路径会错 - 如果后端也参与路由（如 Spring Boot 的 context-path），Nginx proxy_pass 需配合 rewrite 剥离前缀，防止路径叠加
