咱们先拆解你遇到的两个核心问题：加@Configuration启动失败和去掉后Swagger UI空内容，一步步来排查解决：

一、为什么加@Configuration后程序无法运行？ #

大概率是SpringFox版本与你的Spring Boot版本不兼容，或者配置类本身存在语法/细节错误：

• 你用的SpringFox 2.6.1是比较老的版本，如果项目里的Spring Boot是2.x及以上版本，两者会存在冲突（比如Spring MVC路径匹配规则、依赖的Guava版本不一致等）。
• 另外你的配置类代码全部挤在一行，容易出现拼写错误：比如metaInfo()里的Apache License URL写错了，应该是https://www.apache.org/licenses/LICENSE-2.0.html，少了个s，这类小问题也可能导致启动失败。

解决方案： #

1. 版本适配：如果是Spring Boot 2.x，建议升级SpringFox到2.9.2（适配Spring Boot 2.x的稳定版）；如果是Spring Boot 3.x，直接改用SpringDoc（替代SpringFox的新方案，更适配新版本）。
2. 修正配置类语法与格式：把代码格式化，修正细节错误，示例如下：

@EnableSwagger2
@Configuration
public class SwaggerConfig {

    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.techprimers.springboot.swaggerexample"))
                .paths(PathSelectors.regex("/rest.*")) // 注意导入springfox.documentation.builders.PathSelectors
                .build()
                .apiInfo(metaInfo());
    }

    private ApiInfo metaInfo() {
        return new ApiInfo(
                "Spring Boot Swagger Example API",
                "Spring Boot Swagger Example API for Youtube",
                "1.0",
                "Terms of Service",
                new Contact("TechPrimers", "https://www.youtube.com/TechPrimers", "techprimerschannel@gmail.com"),
                "Apache License Version 2.0",
                "https://www.apache.org/licenses/LICENSE-2.0.html"
        );
    }
}

二、去掉@Configuration后启动成功，但Swagger UI无内容？ #

因为去掉@Configuration后，这个类不会被Spring容器扫描并加载，Swagger的配置根本没生效，自然UI里没有任何内容。

关键排查点： #

1. 包扫描路径是否正确：确认你的Controller类是否在com.techprimers.springboot.swaggerexample或其子包下。如果Controller在别的包（比如com.example.controller），Swagger就扫不到任何接口。
2. 路径匹配规则是否匹配接口：paths(PathSelectors.regex("/rest.*"))意味着只有以/rest开头的接口才会被Swagger展示。如果你的接口是/api/user这类路径，就不会被匹配到，可以先改成PathSelectors.any()测试是否能显示接口，再调整规则。
3. 配置类是否被Spring扫描：确保SwaggerConfig所在的包在Spring Boot的扫描范围内。比如你的启动类在com.techprimers.springboot，那SwaggerConfig在com.techprimers.springboot.swaggerexample是能被扫描到的；如果启动类在com.example，需要在启动类上加@ComponentScan(basePackages = {"com.example", "com.techprimers.springboot.swaggerexample"})。

三、额外验证步骤 #

1. 启动项目后，先访问http://localhost:9080/v2/api-docs，如果能看到JSON格式的API文档，说明Swagger配置生效了，只是UI加载有问题；如果返回404，说明配置没生效。
2. 检查Spring Boot日志，启动时是否有Swagger相关的初始化日志（比如Swagger2Controller相关输出），没有的话就是配置类没被加载。

总结一下：先确保版本兼容，修正配置类的语法和扫描路径，保证配置类被Spring加载，再调整路径匹配规则，应该就能解决你的问题了。

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