Spring Boot中Swagger UI配置问题：访问接口报500错误

访问http://localhost:8080/swagger-ui/index.html时返回500错误，尝试多种方案未解决，以下是相关代码及配置信息：

Java代码 #

package com.ishotit.api;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@EnableJpaRepositories
@SpringBootApplication
public class ApiApplication {

    public static void main(String[] args) {
        SpringApplication.run(ApiApplication.class, args);
    }

}

@Configuration(proxyBeanMethods = false)
@EnableWebMvc
class WebConfig implements WebMvcConfigurer {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**").allowedMethods("*").allowedHeaders("*");
    }
}


@Configuration
class SpringFoxConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}

application.properties配置 #

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.datasource.url=jdbc:postgresql://localhost:5432/ishotit
spring.datasource.username=ishotit
spring.datasource.password=apipassword
spring.jpa.generate-ddl=true
spring.jpa.hibernate.ddl-auto=create
springdoc.enable-native-support=true

问题分析 #

1. Swagger实现冲突：代码用的是SpringFox（Swagger2）配置，但配置文件里加了springdoc.enable-native-support=true，SpringDoc和SpringFox是两套独立的Swagger实现，同时存在会触发上下文初始化冲突，导致500错误。
2. @EnableWebMvc的副作用：Spring Boot中添加@EnableWebMvc会关闭MVC自动配置，Swagger所需的静态资源（如UI页面的HTML/CSS/JS）无法被正确映射，引发访问错误。
3. 版本兼容问题：如果用Spring Boot 2.6+版本，SpringFox默认的路径匹配策略和Spring Boot新策略不兼容，会导致请求处理失败。

解决方案 #

方案1：保留SpringFox（适配现有代码）

• 删除配置文件中的springdoc.enable-native-support=true。
• 移除WebConfig类上的@EnableWebMvc注解（Spring Boot会自动配置MVC，无需手动开启）。
• 若为Spring Boot 2.6+版本，在配置文件中添加路径匹配配置：

  spring.mvc.pathmatch.matching-strategy=ant_path_matcher
  

• 确保项目引入SpringFox正确依赖（以Maven为例）：

  <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-boot-starter</artifactId>
      <version>3.0.0</version>
  </dependency>
  

方案2：改用SpringDoc（适配新版Spring Boot）

• 删除所有SpringFox相关代码：包括SpringFoxConfig类、@EnableSwagger2注解。
• 删除配置文件中的springdoc.enable-native-support=true（如需原生支持可保留，但需确保依赖正确）。
• 移除WebConfig类上的@EnableWebMvc注解。
• 添加SpringDoc依赖（以Maven为例）：

  <dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
      <version>2.2.0</version>
  </dependency>
  

• 访问路径改为http://localhost:8080/swagger-ui.html（SpringDoc默认路径）。

额外检查

• 确认PostgreSQL服务已启动，数据库ishotit存在，用户名密码正确。应用启动时数据库连接失败会导致上下文初始化失败，进而引发Swagger访问的500错误。

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