nginx 中 alias 和 proxy_pass 不能共存于同一 location 块，因二者作用阶段不同且语义冲突：alias 用于本地文件路径替换，proxy_pass 用于转发请求到上游服务器；正确做法是按路径拆分 location，分别配置 alias 或 proxy_pass，或用 try_files + error_page 实现 fallback 代理。
Nginx 中 alias 和反向代理（proxy_pass）不能直接混用在同一 location 块里——因为 alias 用于本地文件映射，而 proxy_pass 是把请求转发给后端服务，二者语义冲突。但你可以通过合理拆分 location 或使用变量+条件判断来实现“部分路径走静态文件、部分走代理”的需求。
明确区分静态资源和代理路径
最稳妥的做法是用不同 location 匹配规则，分别处理：
-
location /static/→ 用alias指向本地目录（注意末尾斜杠匹配逻辑） -
location /api/或location /（兜底）→ 用proxy_pass转发到后端
示例配置：
location /static/ {
alias /var/www/myapp/static/;
# 注意：alias 后路径末尾要有 /，且 location 也以 / 结尾，否则映射错位
}
<p>location /api/ {
proxy_pass <a href="https://www.php.cn/link/c099034308f2a231c24281de338726c1">https://www.php.cn/link/c099034308f2a231c24281de338726c1</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}</p><p>location / {
proxy_pass <a href="https://www.php.cn/link/307527f309aa633edcc5f228a5533f25">https://www.php.cn/link/307527f309aa633edcc5f228a5533f25</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}</p>
想让同一前缀下“部分子路径走文件、部分走代理”？用嵌套 location
比如都希望在 /app/ 下，/app/images/ 读本地文件，/app/v1/ 走代理。这时可用精确匹配或正则 location 拆分：
location ^~ /app/images/ {
alias /data/assets/images/;
}
<p>location ^~ /app/v1/ {
proxy_pass <a href="https://www.php.cn/link/74e3122d8341c62364974ff94af60090">https://www.php.cn/link/74e3122d8341c62364974ff94af60090</a>;
}</p><p>location /app/ {
proxy_pass <a href="https://www.php.cn/link/84cd1f88d088c3a15254f37a22f6e5d6">https://www.php.cn/link/84cd1f88d088c3a15254f37a22f6e5d6</a>;
}</p>
注意：Nginx location 匹配优先级是 = > ^~ > ~ > ~* > /，所以用 ^~ 可确保前缀匹配不被正则干扰。
别踩坑：alias 和 proxy_pass 不能共存于一个 location
下面写法是错误的（Nginx 会报错或行为异常）：
location /files/ {
alias /var/data/;
proxy_pass http://storage-service/; ← ❌ 冲突指令，Nginx 不允许
}
如果真需要动态判断——比如根据文件是否存在决定走本地还是代理（类似 fallback），得用 try_files + error_page 配合：
location /media/ {
alias /var/www/uploads/;
try_files $uri @proxy_to_backend;
}
<p>location @proxy_to_backend {
proxy_pass <a href="https://www.php.cn/link/2393f2ba6d1d4aa2c3fb82f8a7a751f3">https://www.php.cn/link/2393f2ba6d1d4aa2c3fb82f8a7a751f3</a>;
}</p>
这样：先尝试找本地文件，找不到就跳转到命名 location 做代理。
路径重写常见问题
用 alias 时，Nginx 会**丢弃 location 匹配部分**，直接拼接 alias 路径；而 proxy_pass 末尾带 / 会**重写路径**，不带则保留原始 URI。
-
location /a/ { alias /b/; }→ 请求/a/file.txt映射为/b/file.txt -
location /a/ { proxy_pass http://x/; }→ 请求/a/file.txt转发为http://x/file.txt -
location /a/ { proxy_pass http://x; }→ 请求/a/file.txt转发为http://x/a/file.txt
这个细节直接影响后端能否正确解析路径，务必核对。
