解决 Nginx 部署,无法访问 Swagger 文档的问题

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

壹言

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

阅读量2.5k

点赞数 2

CC 4.0 BY-SA版权

分类专栏：教程文章标签： Nginx 配置 Swagger Spring Boot 前后端分离

本文链接：https://blog.csdn.net/vcx08/article/details/109405405

教程专栏收录该内容

20 篇文章

订阅专栏

本文档介绍了如何解决通过Nginx访问Swagger文档时遇到的问题。当直接添加/swagger-ui.html路由规则无效时，需要理解Swagger页面伴随的其他请求，并在Nginx配置中添加相应转发规则。解决方案是添加特定的location配置，包括设置proxy_set_header，并指定后端服务地址，以确保所有相关请求被正确转发。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

原文链接: https://www.changxuan.top/?p=1161

起因

昨天的时候，同事遇到了一个问题需要访问一个 nginx 部署的项目的 swagger 文档，但是在路由转发规则那里加上了 swagger-ui.html 之后仍不能访问。平时我们在内网开发，可以直接访问 后端项目ip:port/swagger-ui.html 就可以了。但是目前只有 nginx 所在服务器外网可以访问，所以外面的人想看接口文档只能通过 nginx 转发请求。

解决办法

nginx 的其它配置不需要改动，直接将下面的location 配置添加到你的配置中即可：

location ~* ^(/v2|/webjars|/swagger-resources|/swagger-ui.html){
       proxy_set_header Host $host;
       proxy_set_header  X-Real-IP  $remote_addr;
       proxy_set_header X-Forwarded-For $remote_addr;
       #proxy_set_header Host $host:$server_port;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header X-Forwarded-Port $server_port;
       proxy_pass http://10.18.66.66:8600; # 后端服务地址
}

其实这也不是什么大问题，只要熟悉 nginx 基本配置都可以很快解决。但是我看网上好多博文都没说到关键的地方，大多数在讲应该如何配置 proxy_set_header 。主要的原因则是 swagger-ui.html 页面虽然看着只是一个页面，但是当你打开这个页面的时候还伴随着其它的请求。如果在 nginx 的配置中没有处理那些请求相应的转发规则，那么自然不会显示文档页面。