alias与proxy_pass不能共存于同一location块，因二者语义冲突：alias用于本地文件映射，proxy_pass用于上游代理；正确做法是按路径前缀拆分location，分别配置alias处理静态资源、proxy_pass处理api请求。
当 Nginx 同时使用 alias 和反向代理（proxy_pass）时，二者不能直接共存于同一个 location 块中——因为 alias 用于本地文件系统映射，而 proxy_pass 是转发请求到后端服务，Nginx 会忽略 alias 或报错（如 “alias and proxy_pass cannot be combined”）。
明确区分用途：静态资源走 alias，动态接口走 proxy_pass
典型场景是：前端单页应用（如 Vue/React 打包产物）放在本地目录，但 API 请求需代理到后端服务。这时应拆分 location 规则，避免混用。
- 用
alias处理带路径前缀的静态资源（如/app/→ 对应磁盘目录/var/www/myapp/） - 用
proxy_pass单独匹配 API 路径（如/api/或/app/api/），不与alias冲突 - 注意
alias末尾斜杠和proxy_pass目标 URL 斜杠的匹配逻辑，否则会导致路径拼接错误
正确写法示例：/app/ 映射静态资源，/app/api/ 代理后端
假设你希望访问 https://example.com/app/xxx.html 读取本地文件，而 https://example.com/app/api/users 转发到 http://backend:8000/api/users：
location /app/ {
alias /var/www/myapp/;
index index.html;
try_files $uri $uri/ /app/index.html;
}
location /app/api/ {
proxy_pass http://backend:8000/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
关键点：
– alias /var/www/myapp/; 中末尾必须有 /，且 location 也以 / 结尾，Nginx 才会把 /app/js/app.js 映射为 /var/www/myapp/js/app.js
– proxy_pass http://backend:8000/api/; 末尾带 /，表示将 /app/api/ 前缀**去掉**后再拼到后端路径（即 /app/api/users → http://backend:8000/api/users）
常见错误及修复
- alias + proxy_pass 写在同一 location：Nginx 拒绝加载配置，直接报错
-
alias 路径末尾缺 /：比如
alias /var/www/myapp;，会导致/app/css/style.css查找路径变成/var/www/myappcss/style.css（自动粘连） -
proxy_pass 不带尾部 /：如
proxy_pass http://backend:8000/api;，Nginx 会把完整 URI（含/app/api/）原样转发，后端通常无法识别 - try_files 里漏掉 /app/index.html：SPA 路由刷新 404，需确保 fallback 到入口 HTML（路径要跟 alias 前缀一致）
进阶：统一前缀下动静分离的推荐结构
若所有请求都以 /myapp/ 开头，建议按子路径严格划分：
-
location ^~ /myapp/static/→ alias 到静态资源目录 -
location ^~ /myapp/api/→ proxy_pass 到后端 API -
location /myapp/→ alias + try_files 支持 SPA 路由（兜底）
这样逻辑清晰、互不干扰，也便于后续扩展或权限控制。
