alias 和 proxy_pass 不能共存于同一 location 块，因 alias 用于本地文件路径映射，proxy_pass 用于上游代理，二者语义与处理阶段冲突；正确替代方案是用 proxy_pass 末尾斜杠或 rewrite 配合 proxy_pass 实现路径重写。
alias 指令在 Nginx 中不能和 proxy_pass 同时用于同一个 location 块，这是由设计机制决定的——alias 仅适用于本地文件系统路径映射，而 proxy_pass 是将请求转发给上游服务器。两者语义冲突：Nginx 不允许既重写 URI 路径为本地文件，又把同一请求发给后端。
当你写类似这样的配置时：
location /api/ {
alias /var/www/app/;
proxy_pass http://backend;
}Nginx 会直接报错（如 nginx: [emerg] "alias" directive is not allowed here），或静默忽略 alias，只执行 proxy_pass，甚至行为不可预测。
为什么 alias 和 proxy_pass 不能共存
-
alias替换的是 location 匹配路径 + 后缀部分，最终拼成一个本地文件路径（如/var/www/app/xxx.js）； -
proxy_pass则是构建一个新的 HTTP 请求发给上游，它依赖location的匹配结果来重写 URI； - 它们作用阶段不同：
alias属于内容处理阶段（content phase），proxy_pass属于代理阶段（proxy phase），Nginx 不允许混合使用。
替代方案：用 rewrite + proxy_pass 实现类似 alias 效果
如果你本意是「把 /api/xxx 映射成 http://backend/xxx」，即去掉前缀再转发，正确做法是：
- ✅ 使用
proxy_pass末尾带斜杠，配合location精确匹配：
location /api/ {
proxy_pass http://backend/; # 注意结尾斜杠！
}这样 /api/user/list 会被转发为 http://backend/user/list（自动剥离 /api/）。
- ❌ 错误写法（不带斜杠）：
location /api/ {
proxy_pass http://backend; # 会转发为 /api/user/list → backend/api/user/list
}需要更灵活路径重写？用 rewrite 配合 proxy_pass
比如想把 /v1/api/xxx → /api/xxx 再转发：
location /v1/api/ {
rewrite ^/v1(/api/.*)$ $1 break;
proxy_pass http://backend;
}或者更清晰的写法（推荐）：
location /v1/api/ {
rewrite ^/v1/api/(.*)$ /api/$1 break;
proxy_pass http://backend;
}注意：
-
break表示重写后不再匹配其他 location； -
last会重新匹配 location，可能导致循环，慎用； -
rewrite必须在proxy_pass之前。
如果目标是静态资源代理+路径映射，别用 alias，改用 root + index 或 try_files
例如你想让 /static/ 指向后端某个静态服务的 /assets/：
location /static/ {
proxy_pass http://cdn-server/assets/;
}而不是试图用 alias 去“假装”它是本地路径。
若需本地 fallback（比如 CDN 不可用时回源），可用：
location /static/ {
try_files $uri @backend_fallback;
}
location @backend_fallback {
proxy_pass http://cdn-server/assets/;
}不复杂但容易忽略。核心就一条：alias 是给 root/index/try_files 用的；proxy_pass 的路径控制靠斜杠和 rewrite。
