Spring Boot自定义List<Property>序列化方案求助（不修改模型与控制器）

刚好遇到过类似的场景，给你几个完美适配你限制条件的解决方案——不用修改自动生成的模型类和REST控制器：

方案1：注册泛型类型的自定义序列化器 #

Jackson支持通过TypeReference来注册泛型类型的序列化器，解决你无法直接用List<Property>.class注册的问题。只需在你的配置类里这么写：

@Configuration
public class JacksonConfig {
    @Bean
    public Module propertyListSerializerModule() {
        SimpleModule module = new SimpleModule();
        // 通过TypeReference精准匹配List<Property>类型
        module.addSerializer(new TypeReference<List<Property>>() {}, new PropertyListJSONSerializer());
        return module;
    }
}

这个方案的优势是完全不依赖自动生成的类，Jackson会在序列化任何List<Property>类型的字段时自动触发你的自定义逻辑，其他字段保持默认序列化行为，完美适配WrapperModel字段动态增减的情况。

方案2：使用Jackson混合注解（Mix-in Annotations） #

如果只想针对WrapperModel的properties字段生效，可以用Jackson的混合注解机制，给自动生成的类动态添加注解，无需修改原类代码：

首先创建一个混合类，用来定义properties字段的序列化规则：

public abstract class WrapperModelMixIn {
    @JsonSerialize(using = PropertyListJSONSerializer.class)
    private List<Property> properties;
}

然后在配置类里注册这个混合类：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 给WrapperModel绑定混合注解
        mapper.addMixIn(WrapperModel.class, WrapperModelMixIn.class);
        return mapper;
    }
}

这个方案的好处是精准控制单个类的单个字段，不会影响其他地方的List<Property>序列化，同时保留WrapperModel其他所有字段的默认序列化逻辑。

方案3：从OpenAPI生成器源头配置（推荐长期维护） #

如果可以调整OpenAPI生成器的配置，直接让生成的模型类自带序列化注解，一劳永逸：

步骤1：在OpenAPI规范文件中添加扩展 #

在你的OpenAPI YAML/JSON里，给properties字段添加Jackson序列化器的扩展：

components:
  schemas:
    WrapperModel:
      type: object
      properties:
        # 其他字段...
        properties:
          type: array
          items:
            $ref: '#/components/schemas/Property'
          # 添加Jackson序列化器扩展
          x-jackson-serialize-using: com.your.package.PropertyListJSONSerializer

步骤2：配置OpenAPI生成器启用Jackson扩展 #

以Maven插件为例，在pom.xml里开启Jackson扩展支持：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>6.6.0</version> <!-- 使用最新稳定版 -->
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>spring</generatorName>
                <configOptions>
                    <useJackson>true</useJackson>
                    <enableJacksonExtension>true</enableJacksonExtension>
                    <java8>true</java8>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

这样生成的WrapperModel类中，properties字段会自动带上@JsonSerialize(using = PropertyListJSONSerializer.class)注解，无需后续手动配置Jackson。

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