springboot接口文档拒绝连接

### Spring Boot 中 Swagger 或 Actuator 文档拒绝连接的原因分析 在开发基于 Spring Boot 的应用程序时，如果遇到 Swagger 或 Actuator 接口文档无法访问的情况，通常可能是由于以下几个原因引起的： #### 1. **端口号冲突** 如果应用运行的端口号被其他程序占用或者未正确设置，默认情况下 Spring Boot 应用会监听 `8080` 端口。当该端口不可用时，可能会导致接口文档无法正常加载[^1]。 #### 2. **路径映射错误** 默认情况下，Swagger UI 页面可以通过 `/swagger-ui.html` 访问，而 Actuator 提供的健康检查等信息则可通过 `/actuator/health` 路径访问。如果这些默认路径被修改或拦截器阻止，则可能导致页面无法显示[^2]。 #### 3. **安全配置问题** 若项目启用了 Spring Security 并进行了全局保护策略（如认证授权），那么未经身份验证的请求会被拒绝访问。这可能影响到对 Swagger 和 Actuator API 的调用。 #### 解决方案 以下是针对上述常见问题的具体解决方法： - #### 配置正确的服务器端口 在项目的 `application.properties` 文件中显式指定一个可用的端口号： ```properties server.port=9090 ``` - #### 检查并调整路径匹配规则 对于自定义基础包扫描范围的应用场景下，需确认是否遗漏了必要的组件注册操作；另外还需注意是否存在多余的过滤链干扰到了目标资源定位过程。 修改后的启动类如下所示： ```java @SpringBootApplication(scanBasePackages = {"com.example.demo"}) public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2).select() .apis(RequestHandlerSelectors.basePackage("com.example.controller")) .paths(PathSelectors.any()) .build(); } } ``` - #### 放开特定 URL 的权限控制 编辑 security config 类文件来排除某些敏感区域之外的内容不受限访问： ```java @Configuration @EnableWebSecurity public class WebSecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable(). authorizeRequests(). antMatchers("/v2/api-docs", "/configuration/ui", "/swagger-resources/**","/configuration/security", "/swagger-ui.html", "/webjars/**").permitAll(). anyRequest().authenticated();; } } ``` 以上措施能够有效改善因为网络环境设定不当所引发的一系列异常状况。 ###