Nginx 反向代理只返回 404？最小可用配置与定位流程

安全风信子

发布于 2025-11-18 15:53:52

2280

文章被收录于专栏：AI SPPECHAI SPPECH

一句话承诺：提供最小可用的反向代理配置与时序图，帮你快速定位 404 的真正来源。

对照表：404来源可能性

来源	说明	快速核查
Nginx 路径不匹配	location 写错或层级覆盖	打印 $request_uri 与 location 命中
后端服务404	上游返回的404	访问上游直连端口确认
文件静态路径	root/alias 配置不对	try_files 与目录结构核查

最小可用反向代理配置（示例）

http {
  upstream api {
    server 127.0.0.1:9000;
  }

  server {
    listen 80;
    server_name _;

    # 观测：在响应头注入上游状态
    proxy_set_header X-Real-IP $remote_addr;
    add_header X-Upstream-Status $upstream_status always;

    location /api/ {
      proxy_pass http://api;
      proxy_http_version 1.1;
      proxy_set_header Host $host;
      proxy_set_header Connection "";
    }

    # 静态文件最小配置
    location / {
      root /var/www/html;
      try_files $uri $uri/ /index.html;
    }
  }
}

核查动作

# 1) 直连上游确认是否为后端404
curl -i http://127.0.0.1:9000/api/v1/items

# 2) 查看命中的location
# 在nginx.conf中临时加入：
# add_header X-Location "$uri|$request_uri|$host" always;

# 3) 检查静态目录路径是否存在
ls -lah /var/www/html