关于线上项目部署后使用nginx转发后端,导致knife4j无法访问

5 阅读1分钟

1.首先是knife4j要开启生产模式访问,以及各种生产环境下的访问。

2.我这里讨论的是nginx转发导致的。

我这里的情况是,前端资源是通过nginx部署的,前端的所有请求也都是通过这个nginx转发到后端,后端服务本身的端口不暴漏在公网上。

即,我们通过80端口访问前端资源,前端所有请求也是请求的80端口。只是带个prod-api后缀,然后由nginx根据前缀匹配转发到真实的后端。

我这里导致knife无法访问的原因就是 proxy_set_header X-Forwarded-Prefix /prod-api;没有配置

server {
    listen 80;

    root /usr/share/nginx/html;
    index index.html;

    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;

    # 支持前端路由
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 统一处理所有 /prod-api 前缀的请求,转发到后端 /api_v1
    location /prod-api/ {
        proxy_pass http://system-backend:8080/api_v1/;
        
        # 关键:告诉后端前端访问的前缀是 /prod-api,用于生成正确的资源路径
        proxy_set_header X-Forwarded-Prefix /prod-api;
        
        # 保留其他必要头信息
        proxy_set_header Host $host;
        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 X-Forwarded-Port $server_port;
        
        # 超时配置
        proxy_connect_timeout 300s;
        proxy_read_timeout 300s;
    }

}

3.其他原因基本就是防火墙、以及没有开启knife4j的生产环境启用等