Swagger(Springfox)仅识别@RequestBody模型？无需Dummy方法如何识别全量模型？

这确实是Swagger/OpenAPI自动扫描时的常见痛点——默认情况下，它只会识别直接出现在Controller方法的参数、返回值或注解引用中的模型，像你这种仅在Service层使用的核心User模型，哪怕加了@ApiModel注解，也会被漏掉。不用写Dummy方法，有几种优雅的解决方案可以选：

方案1：手动在Swagger配置中注册模型（SpringFox/Swagger 2） #

如果你的项目用的是传统SpringFox实现，可以通过自定义Docket配置，手动把User模型加入到Swagger文档中：

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Autowired
    private TypeResolver typeResolver;

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.withClassAnnotation(RestController.class))
                .paths(PathSelectors.any())
                .build()
                // 手动注册User模型
                .additionalModels(typeResolver.resolve(User.class));
    }
}

这段代码会强制Swagger把User类加入到文档的Schemas部分，哪怕它没有被任何Controller方法直接引用。

方案2：通过包扫描自动识别模型（SpringDoc/OpenAPI 3） #

如果你的项目已经升级到SpringDoc（适配OpenAPI 3规范），操作会更简单——直接在配置文件中指定模型所在包，SpringDoc会自动扫描该包下所有带有@Schema（或兼容的@ApiModel）注解的类：

在application.properties中添加：

# 替换成你的核心模型实际所在包路径
springdoc.packages-to-scan=com.yourproject.domain.models

这样所有该包下的业务模型，不管有没有被Controller引用，都会自动加入到Swagger UI的Schemas里。

方案3：通过已识别DTO关联模型（兼容所有版本） #

如果不想修改配置，也可以在某个已被Swagger识别的DTO（比如你的LoginCredentialsDTO）中，添加一个隐藏的关联属性，让Swagger间接扫描到User模型：

@ApiModel(description = "登录凭证DTO")
public class LoginCredentialsDTO {
    // 原有的属性
    private String username;
    private String password;

    // 仅用于Swagger扫描的隐藏属性，不会出现在文档中
    @ApiModelProperty(hidden = true)
    private User dummyUser;
}

这个属性不会在Swagger UI中显示，但会触发Swagger扫描User类，将其加入到Schemas里。这种方式适合临时快速解决问题，但如果模型较多，还是推荐前面的配置类方案。

注意事项 #

• 若使用SpringFox，确保@ApiModel注解是io.swagger.annotations.ApiModel而非SpringDoc的注解；
• 若使用SpringDoc，它会自动兼容Swagger 2的注解，但更推荐使用io.swagger.v3.oas.annotations.media.Schema标记模型。

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