springboot Swigger3“无法加载远程配置。”

Question

带Springdoc的Spring Boot 2.6.3。

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

在应用程序中。yaml，当我将路径设置为/v3/api docs或将其删除时，这意味着使用默认路径“/v3/api docs”。Swagger UI页面与API一起正确显示http://localhost:8080/swagger-用户界面/索引。html

但我想覆盖下面的路径

  api-docs.path: /bus/v3/api-docs

然后SwaggerUI显示"加载远程配置失败"错误：

Answer 1

我也遇到了同样的问题，解决方法是在应用程序中添加以下属性。yml

server:
  forward-headers-strategy: framework

由于以下原因，这是必要的

Swagger依靠内部路由从客户端角度发出请求。将服务放在反向代理后面而不提供X转发头将导致用户无法按预期使用文档

来源-

Answer 2

在浏览器中执行“空缓存和硬刷新”。

Answer 3

如果您在应用程序中使用Spring Security，您必须在配置中包含URL。请将下面的代码添加到您的项目中。

@Configuration
public class WebSecurityConfiguration extends WebSecurityConfigurerAdapter {
    @Override
    public void configure(WebSecurity web) throws Exception {
        web.ignoring().antMatchers("/swagger-ui/**", "/bus/v3/api-docs/**");
    }
}