你遇到的问题核心在于组件扫描范围不匹配，以及Swagger的API扫描配置没有明确指定控制器所在包，导致移到config包后无法识别到控制器类。

为什么原来位置正常，移到config包就失效？ #

当SwaggerConfig在原项目结构位置时，它和你的控制器类处于Spring Boot默认的组件扫描范围内（Spring Boot主类默认会扫描自身所在包及其子包下的所有@Component/@Configuration等注解类）。但移到config包后，如果这个包不在主类的扫描范围内，或者你没有明确指定扫描控制器的包，Swagger的Docket配置就找不到要生成文档的API控制器。

另外你注释掉了@ComponentScan注解，这相当于放弃了手动指定扫描范围，完全依赖Spring Boot的默认扫描规则，一旦config包和控制器包不在同一扫描层级，就会出问题。

具体解决方案 #

方案1：恢复并正确配置@ComponentScan

取消@ComponentScan的注释，同时指定控制器所在包和config包的路径，确保Spring能扫描到所有需要的类：

@Configuration
@EnableAutoConfiguration
@ComponentScan(basePackages={"com.javainuse.swaggertest", "com.javainuse.swaggertest.config"})
@EnableSwagger2
public class SwaggerConfig {
    // 原有代码不变
    @Bean
    public Docket postsApi() {
        return new Docket(DocumentationType.SWAGGER_2).groupName("public-api")
                .apiInfo(apiInfo()).select().paths(postPaths()).build();
    }
    // ... 其他方法不变
}

注意：把com.javainuse.swaggertest替换成你实际的控制器根包路径，com.javainuse.swaggertest.config是你的SwaggerConfig所在的config包路径

方案2：在Docket中明确指定API扫描的包

在Docket的select()后添加apis()方法，直接告诉Swagger要扫描哪个包下的控制器，这种方式更精准，不需要依赖Spring的组件扫描：

@Configuration
@EnableAutoConfiguration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket postsApi() {
        return new Docket(DocumentationType.SWAGGER_2).groupName("public-api")
                .apiInfo(apiInfo())
                .select()
                // 这里指定控制器所在的包
                .apis(RequestHandlerSelectors.basePackage("com.javainuse.swaggertest.controller"))
                .paths(postPaths())
                .build();
    }
    // ... 其他方法不变
}

这种方式的好处是，即使SwaggerConfig在任何位置，只要指定了控制器的包，Swagger就能找到对应的API。

方案3：调整包结构让默认扫描覆盖所有类

确保你的Spring Boot主类所在的包是根包，比如主类在com.javainuse.swaggertest，然后把config包和controller包都作为它的子包：

com.javainuse.swaggertest
├── SwaggerTestApplication.java (主类)
├── config
│   └── SwaggerConfig.java
└── controller
    └── 你的控制器类.java

这样Spring Boot默认的组件扫描会自动扫描主类所在包下的所有子包，不需要额外配置@ComponentScan，SwaggerConfig和控制器都会被正确加载。

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