API网关聚合微服务Swagger失败：绝对URL拼接异常问题

老哥，这个问题我之前碰到过好几次，核心就是URL拼接时没处理好分隔符，或者配置逻辑出错导致网关路径和服务完整URL直接硬凑在了一起。咱们来一步步修正：

1. 定位错误根源 #

从报错的URL http://localhost:8070/apihttp://localhost:8081/api/v2/api-docs 能一眼看出来：你的代码里把网关的基础路径（/api）和服务的完整文档URL（http://localhost:8081/api/v2/api-docs）直接拼接了，没有做任何分隔或逻辑判断，才出现这种两个URL粘在一起的奇葩情况。

2. 针对性修复方案 #

根据你用的API网关类型（比如Spring Cloud Gateway/Zuul），常见的正确配置方式有两种：

方式一：通过网关路由代理服务文档（推荐） #

这种方式不需要直接写服务的IP和端口，而是利用网关已有的路由规则，用相对路径访问服务的文档：

• 先确保网关已经给目标服务配置了路由，比如将/api/serviceA/** 转发到 http://localhost:8081/api/**
• 然后在Swagger聚合配置中，设置服务文档的location为网关代理后的相对路径：

SwaggerResource serviceAResource = new SwaggerResource();
serviceAResource.setName("服务A");
// 用网关代理后的路径，不需要写服务的IP
serviceAResource.setLocation("/api/serviceA/v2/api-docs");
serviceAResource.setSwaggerVersion("2.0");

方式二：直接使用服务的完整文档URL #

如果必须用绝对URL，那不要拼接网关的基础路径，直接把服务的完整文档地址设置为location：

SwaggerResource serviceAResource = new SwaggerResource();
serviceAResource.setName("服务A");
// 直接写服务的完整文档URL，不需要加网关的/api前缀
serviceAResource.setLocation("http://localhost:8081/api/v2/api-docs");
serviceAResource.setSwaggerVersion("2.0");

3. 额外注意事项 #

• 检查网关的CORS配置：如果用方式二，要确保网关允许跨域请求访问服务的文档地址，否则浏览器会拦截请求
• 验证路由规则：如果用方式一，先手动访问http://localhost:8070/api/serviceA/v2/api-docs，确认能正常返回服务的Swagger JSON，再配置聚合

这样调整后，Swagger就能正确加载各个服务的文档了～

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