spring-gateway整合swagger2统一微服务接口文档

spring-gateway整合swagger2统一微服务接口文档

微服务都是通过API网关去统一访问,而不是由外部直接调用服务,也可以将所有微服务的swagger2统一从网关访问

整合需要解决的问题

由于spring-cloud-gateway是使用webflux,与springmvc是冲突的,所以当我们使用传统的配置swagger2的方法去配置时,就会出现以下一些错误

  1. 使用@EnableSwagger2注解导致无法找到Servlet组件,一般是提示无法加载Filter类、Servlet类
  2. 为了解决第一个问题,引入spring-web-starter或者springmvc依赖,导致容器启动报错,提示容器无法识别应该使用那种类型的http组件,webflux是基于netty,基于reacter组件,springmvc是传统的web组件,基于servlet。

解决方案

兼容webflux,重写获取api-docs信息的配置,具体请参考一位掘金大佬的配置
掘金

相关推荐
stark张宇14 小时前
微服务架构必备:Gin + gRPC + Consul + Nacos + GORM 打造用户服务
微服务·gin·grpc
NE_STOP3 天前
springMVC-HTTP消息转换器与文件上传、下载、异常处理
spring
JavaGuide3 天前
Claude Opus 4.6 真的用不起了!我换成了国产 M2.5,实测真香!!
java·spring·ai·claude code
玹外之音4 天前
Spring AI MCP 实战:将你的服务升级为 AI 可调用的智能工具
spring·ai编程
来一斤小鲜肉4 天前
Spring AI入门:第一个AI应用跑起来
spring·ai编程
NE_STOP4 天前
springMVC-常见视图组件与RESTFul编程风格
spring
阿里云云原生4 天前
MSE Nacos Prompt 管理:让 AI Agent 的核心配置真正可治理
微服务·云原生
阿里云云原生4 天前
阿里云微服务引擎 MSE 及 API 网关 2026 年 1 月产品动态
微服务
what丶k4 天前
Spring AI 多模态开发全解析:从入门到企业级落地
后端·spring·ai编程