Nginx配置无法转发至应用服务器问题排查求助

我在AWS ECS Fargate容器中部署Nginx，遇到配置无法转发请求至应用服务器的问题。该配置是从其他可用场景复制而来，仅移除了443相关配置。传入的${NGINX_HOST}变量当前为Web应用前端ALB的URL，尝试替换为localhost也无任何变化。我通过构建包含自定义配置文件的镜像并上传至Docker Hub，再拉取该镜像来更新Nginx配置进行测试，恳请帮忙分析配置失效的原因，或提供部署后验证其指向的测试方法。

map $sent_http_content_type $charset {
        ~^text/ utf-8;
}

server {
    listen 80;
    listen [::]:80;
    server_name ${NGINX_HOST};

    proxy_set_header    X-Forwarded-Host   $host;
    proxy_set_header    X-Forwarded-Server $host;
    proxy_set_header    X-Forwarded-For    $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto  $scheme;
    proxy_set_header    X-Real-IP          $remote_addr;
    proxy_set_header    Host               $host;

    location / {
        add_header Access-Control-Allow-Origin *;
        try_files $uri @proxy;
    }

    location @proxy {
        proxy_buffers 32 5m;
        proxy_buffer_size 5m;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-NginX-Proxy true;
        proxy_pass http://${NGINX_HOST}:3000;
        proxy_redirect off;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

可能的失效原因 #

• 循环转发死循环：proxy_pass使用了${NGINX_HOST}:3000，而该变量是前端ALB的URL。如果ALB的目标组指向这个Nginx容器，会导致请求在ALB和Nginx之间来回跳转，永远无法到达应用服务器。
• 变量替换失败：Nginx启动时若未正确替换${NGINX_HOST}，配置中的server_name和proxy_pass会保留变量名，导致Nginx无法匹配请求或转发至错误地址。可进入容器查看实际生成的配置文件确认。
• 应用服务器不可达：Fargate容器内的Nginx能否访问${NGINX_HOST}:3000？若应用服务器与Nginx不在同一VPC，或安全组配置有误，Nginx将无法连接后端服务。
• try_files逻辑干扰：try_files $uri @proxy会优先尝试访问Nginx本地静态文件，若请求路径匹配到本地文件，将直接返回而不转发。
• server_name匹配失败：若请求的Host头与${NGINX_HOST}不一致，Nginx不会使用该server块处理请求，而是调用默认server块（若存在）。

验证测试方法 #

• 检查生效配置：进入Nginx容器，执行cat /etc/nginx/conf.d/[你的配置文件名].conf，查看${NGINX_HOST}是否被正确替换为实际地址。
• 测试容器内连通性：在容器内执行curl http://[实际后端地址]:3000，确认能否收到应用服务器的响应。若连不上，说明网络层面存在问题，需检查安全组、VPC配置或应用服务器监听状态。
• 查看Nginx日志：执行tail -f /var/log/nginx/access.log和tail -f /var/log/nginx/error.log，观察请求是否被接收、转发时是否出现报错（如连接超时、拒绝连接）。
• 简化配置测试：临时将server_name改为_（匹配所有请求），proxy_pass直接写应用服务器的内网IP:3000（若已知），重启Nginx后测试转发是否成功，排除变量和server_name的问题。
• 验证try_files逻辑：请求一个不存在的路径（如/test-404-path），观察是否会触发@proxy转发。若该请求能成功转发，说明之前的请求因匹配到本地静态文件未触发转发。

内容的提问来源于stack exchange，提问作者weteamsteve