AWS Linux 2环境Nginx反向代理返回Cannot GET /api错误如何解决？

根本原因 #

你遇到的问题核心是Nginx proxy_pass 指令的路径处理逻辑差异，以及配置未正确加载：

• 当proxy_pass末尾不带斜杠时：请求/api/xxx会被完整转发到http://127.0.0.1:3000/api/xxx
• 当proxy_pass末尾带斜杠时：请求/api/xxx会被自动去掉/api前缀，转发到http://127.0.0.1:3000/xxx
  你最初的配置无效果，大概率是反向代理的location块没有放到生效的server块内，或者配置文件未被Nginx加载。

排查步骤 #

1. 先验证后端服务可用性
   在服务器本地执行命令确认3000端口服务正常：

curl http://127.0.0.1:3000
curl http://127.0.0.1:3000/你要测试的接口路径

2. 确认配置已被Nginx加载
   执行以下命令查看Nginx完整加载的所有配置，确认你的反向代理规则存在：

nginx -T

3. 检查配置语法合法性
   每次修改配置后执行：

nginx -t

返回syntax is ok和test is successful后，再执行重载命令生效：

systemctl reload nginx

4. 查看日志定位问题
   访问出错后查看日志确认转发路径是否符合预期：

# 查看错误日志
tail /var/log/nginx/error.log
# 查看访问日志
tail /var/log/nginx/access.log

正确配置方案 #

根据你的后端服务路由规则二选一即可：

场景1：后端服务本身带/api前缀 #

即后端接口路径本身就是/api/xxx，直接将以下配置添加到Nginx默认80端口的server块内部即可：

location /api {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

场景2：后端服务没有/api前缀 #

即后端接口路径是/xxx，需要Nginx自动去掉/api前缀再转发，使用rewrite规则更稳定：

location /api {
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

补充：localhost不生效解决方法 #

如果http://localhost:3000无法访问，检查/etc/hosts文件是否存在以下配置，没有就手动添加：

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6

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