Alias 和 proxy_pass 不能共用，这是 Nginx 的设计限制而非配置错误；需严格分离静态文件服务（用 alias）与代理转发（用 proxy_pass），并通过 location 前缀隔离、proxy_pass 末尾斜杠控制路径重写。
Alias 和 proxy_pass 不能共用，Nginx 会直接报错或静默忽略 alias —— 这不是配置疏漏，而是设计限制。排查重点不在“怎么修语法”，而在于确认是否误用了 alias、是否混淆了静态服务与代理转发的职责边界。
先确认是否真的混用了 alias 和 proxy_pass
检查所有含 proxy_pass 的 location 块，逐行确认：里面有没有出现 alias 指令？哪怕只有一行，Nginx 启动时就会报 [emerg] "alias" directive is not allowed here。如果没报错但行为异常，可能是你改过配置却没重载（nginx -s reload），或用了 include 引入了隐藏配置。
- 运行
nginx -t验证语法，这是第一步，不是可选项 - 查看 error log（通常是
/var/log/nginx/error.log），搜索alias或proxy_pass相关警告 - 用
nginx -T输出完整生效配置，人工扫一遍所有 location /xxx/ { ... } 块
判断实际需求：你要的是静态文件服务，还是路径转发？
很多人写 alias /path; proxy_pass http://up;，本意其实是“把 /api/ 下的请求去掉前缀再发给后端”，结果误用了 alias。alias 只管本地文件映射，和 upstream 完全无关。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 如果你访问
/api/user期望转发到后端的/user→ 应该用proxy_pass http://up/;（结尾带斜杠） - 如果你访问
/static/js/app.js期望返回磁盘上的某个文件 → 才该用alias /var/www/dist/static/; - 两者不能在一个 location 里共存；要分开写两个 location，按路径前缀严格隔离
验证转发路径是否被正确剥离
proxy_pass 末尾斜杠是关键开关，它决定 URI 是否被重写。错误的斜杠会导致后端收到带前缀的路径（如 /api/user），而后端路由只认 /user，最终 404。
- 在后端加日志或用
curl -v查看真实收到的请求路径 - 对比：location /api/ { proxy_pass http://up; } → 后端收到
GET /api/user - 对比：location /api/ { proxy_pass http://up/; } → 后端收到
GET /user - 若需更复杂重写（如 /v1/api/ → /api/），必须用
rewrite+proxy_pass，且 rewrite 必须写在 proxy_pass 之前
检查静态资源是否被 proxy_pass 意外拦截
当 alias 本该服务静态文件，却因 location 顺序或正则匹配问题，被上面某个更宽泛的 proxy_pass location 先捕获，就会导致 JS/CSS 返回 502 或 HTML 内容。
- 确保静态资源 location（如
location ~*\.(js|css|png)$或location /static/）写在 proxy_pass location 之前 - 避免用
location / { proxy_pass ... }这种兜底写法，它会覆盖所有未匹配路径，包括本该走 alias 的 - alias 值末尾建议统一加斜杠（如
alias /var/www/app/;），和 location 路径风格保持一致，防止路径拼接多出空段
