Nginx转发代理后swagger3的server接口异常

最新推荐文章于 2025-05-14 11:23:49 发布

nanfeng16

最新推荐文章于 2025-05-14 11:23:49 发布

阅读量511

点赞数 7

文章标签： nginx 运维 spring boot

swagger页面访问异常

由于系统spring-boot主版本从2.3升到2.7，swagger2也需要同步升级为springdoc-openapi版本，之前一直用的好好的，部署到公网服务器后发现，通过nginx转发代理方位swagger页面的接口都无法进行测试了，访问到接口都是127.0.0.1:{程序应用端口}，之前swagger2不会有这个问题，会自动将访问地址生成到公网ip：公网端口

springdoc依赖版本

        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-ui</artifactId>
            <version>1.7.0</version>
        </dependency>

swagger2场景下正常访问地址

外网访问端口8280，接口访问时也会使用这个开发地址和端口

到了swagger3，接口访问就全部变成127.0.0.1:9100（代理转发后的地址）
在这里插入图片描述
并且接口测试也全都使用的127这个地址，无法测试了

解决办法

通过网上查找资料，大部分都是针对swagger2的解决办法，在进行源码查看之后，swagger3生成server时，如果没有指定测试服务器，会自动引用请求、swagger-ui/index.html这个请求时的路由作为服务器，经过nginx转发之后就是 127.0.0.1:9100这个本地访问地址了。
网上大部分的通过nginx配置Http请求头设置后未成功，排查后发现：
在这里插入图片描述
最后修改过的nginx配置应如下：

        location /{程序子路由}/ {
                proxy_pass http://127.0.0.1:9100/{程序子路由}/;
                proxy_http_version 1.1; #这里必须使用http 1.1
                proxy_set_header Host $http_host;  # 这里要用 $http_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;
        }