Swagger Codegen生成DTO时TYPE级Bean Validation注解未生成如何解决？

你遇到的是OpenAPI/Swagger代码生成器默认未适配类级别自定义校验注解的问题，具体分为3个常见原因：

• 默认的x-constraints扩展仅针对属性级别做了处理，代码生成器的内置模板没有读取Schema根节点（类级别）下的x-constraints配置
• 未开启Bean Validation注解生成的全局开关
• 未配置自定义注解的全限定名映射，生成器无法识别@MyAnnotation对应的包路径

1. 开启校验注解生成开关 #

根据你使用的生成器类型调整配置：

• 若使用OpenAPI Generator：确保配置项useBeanValidation、generateValidationAnnotations均设为true
• 若使用旧版Swagger Codegen：开启useBeanValidation配置为true

2. 自定义代码模板适配类级别注解 #

默认的POJO生成模板没有处理类级别的x-constraints，你需要修改对应语言的DTO类模板：
以OpenAPI Generator的Java类模板pojo.mustache为例，在类定义的上方新增以下模板逻辑，即可读取类级别配置的注解：

{{#vendorExtensions.x-constraints}}
{{{.}}}
{{/vendorExtensions.x-constraints}}

注意使用三个大括号{{{}}}输出内容，避免注解符号被转义

3. 配置自定义注解的导包规则 #

有两种方式处理导包问题：

• 直接在x-constraints中写注解的全限定名，比如：

  MyDTO:
    type: object
    x-constraints: '@com.xxx.validation.MyAnnotation'
  

• 在生成器配置中添加导入映射，比如：

  importMappings:
    MyAnnotation: "com.xxx.validation.MyAnnotation"
  

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