Java6 SOAP项目转Java8 Spring Boot后Swagger2白屏报错求助

嘿，我来帮你搞定这个头疼的问题！你遇到的场景很典型——自动注入服务前Swagger好好的，注入后直接白屏加控制台报错，结合你用的Java8、Spring Boot和Springfox 2.8.0，咱们一步步排查解决：

1. 先补全Swagger UI依赖（90%的白屏都栽在这） #

看你贴的POM只提到了springfox-swagger2，大概率漏了springfox-swagger-ui依赖！Swagger2负责生成API文档数据，UI包才是负责渲染页面的，没它肯定白屏。赶紧补上，顺便把版本升级到更兼容Java8的2.9.2（2.8.0太老，和Spring Boot 2.x适配性差）：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

2. 检查Swagger配置类的扫描范围 #

自动注入服务后，Swagger的扫描路径可能没覆盖到你的业务类，或者被注入的服务干扰了扫描逻辑。确保你的Swagger配置类正确配置了扫描包：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                // 替换成你实际的controller/服务所在包路径
                .apis(RequestHandlerSelectors.basePackage("com.your.project.package"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("项目API文档")
                .description("接口详情描述")
                .version("1.0")
                .build();
    }
}

注意：别让Swagger配置类注入业务服务，保持它的独立性，避免被业务逻辑干扰

3. 排查控制台报错的具体原因 #

你说Chrome控制台持续报错，一定要盯着报错内容看：

• 如果是Uncaught TypeError这类前端JS错误：大概率是Swagger UI静态资源加载失败，或者API文档生成时遇到了循环依赖（自动注入服务后很容易出现这种情况）。解决循环依赖可以给冲突的Bean加@Lazy注解延迟加载。
• 如果是404错误：检查Swagger UI的访问路径，Spring Boot 2.x默认是http://localhost:8080/swagger-ui.html，部分版本可能需要用/swagger-ui/结尾。

4. 修复Spring Boot资源映射冲突 #

如果你的项目自定义了WebMvc资源映射，可能会覆盖Swagger的静态资源路径。需要手动添加Swagger资源的映射规则：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射Swagger UI页面
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        // 映射Swagger UI的静态资源（webjars）
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}

按照上面的步骤来，基本能解决你的问题。先补依赖再检查配置，大部分情况都能搞定！

内容的提问来源于stack exchange，提问作者Burst of Ice