nginx 的 alias 指令在正则 location 中被官方禁止使用，虽语法通过但运行时静默失效，导致 404；因其依赖静态 uri 前缀，而正则匹配无固定前缀，无法动态截取；应改用 root + rewrite 或 try_files 组合实现。
Nginx 的 alias 指令在正则 location 中根本不能用——这不是“踩坑”，而是官方明确禁止的行为。
alias 不支持正则 location，语法通过但运行时失效
虽然 Nginx 配置检查（nginx -t）不会报错，但只要 location 用了 ~ 或 ~*，里面配的 alias 就会被直接忽略。Nginx 会退回到默认行为：按 root 规则拼路径，导致 404。
- 错误写法（看似合理，实则无效）：
location ~ ^/bbs/ {
alias /var/www/bbs/;
}
- 请求
/bbs/index.html时，Nginx 实际查找的是/var/www/html/bbs/index.html（即按默认root路径拼），而不是你期望的/var/www/bbs/index.html。 - 这种“静默失效”最难排查，日志里只显示 404，配置本身又不报错。
为什么设计上禁用？底层逻辑冲突
alias 的核心是“替换前缀”：它依赖 location 的匹配结果是一个**确定、静态的 URI 前缀**（比如 /static/），才能准确砍掉那一段再代入物理路径。
- 正则
location匹配的是模式，不是固定前缀。例如~ ^/api/v\d+/可能匹配/api/v1/users或/api/v2/posts，每次匹配截掉的部分长度不同。 -
alias没有机制去动态解析正则捕获组并做路径替换，它只认字面匹配的前缀。
替代方案：用 root + rewrite 或 try_files 绕过
想实现类似效果，必须放弃 alias，改用组合指令：
-
推荐：root + rewrite
先用rewrite把 URI 重写成与物理结构对齐的形式，再用root自然拼接：location ~ ^/bbs/(.*)$ {
rewrite ^/bbs/(.*)$ /$1 break;
root /var/www/bbs;
}-
更稳妥：try_files + root
适用于需要 fallback 的场景，比如单页应用或带版本号的 API 文档：location ~ ^/api/v(?
\d+)/docs/(.*)$ {
root /opt/swagger-ui/v$ver;
try_files /$2 /index.html =404;
}- 注意：Nginx 原生
alias不支持引用正则捕获变量（如$1），强行写alias /opt/swagger-ui/v$1/;会直接报错或无效。
- 注意：Nginx 原生
真正能用 alias 的地方：只有前缀匹配 location
只有满足三个条件时，
alias才安全可靠：-
location是普通前缀（如/assets/）或带^~修饰符（如^~ /static/）； -
location结尾斜杠与alias结尾斜杠严格一致（/assets/→alias /srv/assets/;）； - 物理路径中不依赖动态片段，纯静态映射。
一旦涉及正则、变量、路径重写或版本路由，就该切换思路，别硬套
alias。 -
更稳妥：try_files + root
