如何在OpenApi Generator生成的Spring DTO中实现类似@JsonSerialize(customSerialized)的自定义序列化行为？

我来给你梳理几个实际项目里常用的可行方案，你可以根据自己的场景来选：

方案1：通过OpenAPI Spec给字段加自定义注解 #

这是最直接的方式，不用修改生成后的代码，直接在你的OpenAPI YAML/JSON规范里给目标字段加上x-java-annotation扩展，把@JsonSerialize注解写进去就行。比如：

components:
  schemas:
    ProductDTO:
      type: object
      properties:
        price:
          type: number
          format: decimal
          x-java-annotation: "@JsonSerialize(using = TwoDecimalSerializer.class)"

要注意的是，你需要确保使用的OpenApi Generator版本支持这个x-java-annotation扩展（一般v5以上都支持），另外在生成配置里要开启注解相关的开关，比如Maven插件里的configOptions要加上enableJavaAnnotations=true。

方案2：自定义代码生成模板批量处理 #

如果你的项目里有大量同类型的字段需要加这个序列化注解（比如所有BigDecimal类型的字段），一个个在Spec里加太麻烦，那可以自定义OpenApi Generator的生成模板：

• 先找到OpenApi Generator官方的Spring DPO模板（比如pojo.mustache），把它拷贝到你本地项目的src/main/resources/templates目录下
• 打开这个模板，找到字段定义的区域，添加判断逻辑：如果字段是decimal类型，就自动插入@JsonSerialize(using = TwoDecimalSerializer.class)注解
• 最后在生成配置里指定templateDirectory指向你本地的模板目录，这样重新生成的所有符合条件的DTO字段都会自动带上这个注解

方案3：用Jackson全局模块统一配置 #

完全不用碰DTO代码的方案——通过Jackson的自定义模块全局注册序列化规则。比如写一个Jackson模块，指定对特定类型或字段应用你的序列化器：

public class TwoDecimalSerializerModule extends SimpleModule {
    public TwoDecimalSerializerModule() {
        // 方式1：对所有BigDecimal类型的字段应用序列化器
        addSerializer(BigDecimal.class, new TwoDecimalSerializer());
        
        // 方式2：只对特定字段名或特定DTO的字段应用
        setSerializerModifier(new BeanSerializerModifier() {
            @Override
            public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) {
                for (BeanPropertyWriter writer : beanProperties) {
                    // 比如只给名字带"amount"或"price"的字段加序列化器
                    if (writer.getName().contains("amount") || writer.getName().contains("price")) {
                        writer.assignSerializer(new TwoDecimalSerializer());
                    }
                }
                return beanProperties;
            }
        });
    }
}

然后在Spring配置里把这个模块注册到ObjectMapper中，这样Jackson序列化时就会自动对符合规则的字段应用你的自定义序列化器，完全不用修改生成的DTO。

方案4：通过Mapper层隔离转换 #

如果你已经有一套手写的内部DTO，不想改动生成代码和OpenAPI Spec，那可以把序列化逻辑移到Mapper层：

• 用MapStruct或者ModelMapper这类工具，把OpenApi生成的DTO转换为你手写的内部DTO
• 在手写的内部DTO的对应字段上加上@JsonSerialize(using = TwoDecimalSerializer.class)注解
• 对外暴露的接口用内部DTO做返回，这样既保留了生成DTO的便利性，又能实现自定义序列化的需求，还隔离了生成代码和业务逻辑，以后更新OpenAPI Spec重新生成DTO也不会影响业务代码

这些方案各有优劣，你可以根据自己的项目规模和需求来选：如果是少数字段用方案1，批量处理用方案2，全局统一规则用方案3，已有内部DTO层用方案4~

备注：内容来源于stack exchange，提问作者razor