Openshift中Nginx proxy_pass无法转发请求至后端问题排查

问题分析 #

你的Angular应用通过Nginx正常访问，但前端发起的/login/authenticate这类请求没有被Nginx转发到后端服务，而是返回503错误；硬编码后端URL请求正常，说明问题出在Nginx的转发配置或Pod网络连通性上。

排查与解决方案 #

1. 确认Nginx是否接收并匹配到目标请求 #

查看Nginx访问日志（路径：/opt/middleware/nginx/latest/log/nginx/access.log），定位/login/authenticate对应的日志条目：

• 若日志无该请求：说明请求未到达Nginx，需检查Openshift路由配置；
• 若日志存在但状态码为503：说明Nginx已转发请求，但无法连接后端或后端返回503。

2. 验证Nginx Pod到后端服务的连通性 #

进入Nginx的Pod，执行命令测试后端接口可达性：

curl -v https://springbootapi.ecs.dyn.net/login/authenticate

• 若无法访问：说明是Openshift网络策略或服务发现问题
  • 检查是否有网络策略阻止Nginx Pod访问后端服务所在命名空间；
  • 确认后端域名springbootapi.ecs.dyn.net在Nginx Pod内可正常解析。

3. 调整Nginx proxy_pass配置并添加必要参数 #

修改/login/和/entitlement/的location配置，强制前缀匹配并补充SSL代理参数：

location ^~ /login/ {          
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header        X-Forwarded-Proto $scheme;
    proxy_set_header        Host $host;  # 传递请求Host头给后端
    proxy_http_version 1.1;
    proxy_ssl_server_name on;  # 启用SNI，解决HTTPS后端域名匹配问题
    proxy_ssl_verify off;  # 后端用自签证书时添加；生产环境建议配置可信CA证书
    proxy_pass https://springbootapi.ecs.dyn.net;
}

location ^~ /entitlement/ {                
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header        X-Forwarded-Proto $scheme;
    proxy_set_header        Host $host;
    proxy_http_version 1.1;       
    proxy_ssl_server_name on;
    proxy_ssl_verify off;
    proxy_pass https://springbootapi.ecs.dyn.net;
}

• ^~修饰符：强制Nginx优先匹配该前缀location，避免被后续/ location覆盖；
• proxy_set_header Host $host：确保后端服务能正确识别请求的Host头；
• proxy_ssl_server_name on：解决HTTPS后端的SNI匹配问题，避免证书验证失败。

4. 检查环境变量替换正确性 #

确认Nginx配置中root /nginxapps/html/<%= ENV["APP_ROOT"] %>/public的APP_ROOT环境变量是否被正确替换：

• 在Pod内执行echo $APP_ROOT查看变量值；
• 若变量为空，root路径会变为/nginxapps/html//public，虽不影响转发，但可能导致静态文件加载异常，建议确认变量配置。

验证 #

修改配置后重启Nginx（或重新部署Openshift应用），测试前端请求/login/authenticate是否正常转发到后端。

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