Hibernate修改标记与集合序列化问题及Spring Boot配置求助

问题根源 #

你之前的配置错误地将前端JSON序列化和JPA持久化两个独立环节的逻辑混在一起，自定义的EmptyAsNullCollectionJacksonAnnotationIntrospector干扰了Jackson默认的类型解析机制，导致：

• 序列化逻辑异常，输出仅为空/空数组
• 反序列化时无法识别集合泛型，元素被转为LinkedHashMap

分步解决 #

1. 前端JSON序列化：Null集合转为空集合（自动化）

改用Jackson的SimpleModule添加自定义序列化器，保留默认类型处理逻辑，避免反序列化异常：

@Bean
public Module collectionNullToEmptyModule() {
    return new SimpleModule()
            .addSerializer(Collection.class, new JsonSerializer<Collection<?>>() {
                @Override
                public void serialize(Collection<?> value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
                    // 序列化时将null集合转为空数组
                    if (value == null) {
                        gen.writeStartArray();
                        gen.writeEndArray();
                    } else {
                        gen.writeObject(value);
                    }
                }
            });
}

这个配置只会影响JSON序列化输出，不干扰反序列化的类型解析，保证含元素的集合能正确转为对应Java对象。

2. 持久化前：空集合转为Null（避免Envers误触发修改标记）

通过JPA生命周期回调，在实体保存/更新前自动将空集合设为Null，无需手动处理：

@MappedSuperclass
public abstract class BaseEntity {

    @PrePersist
    @PreUpdate
    void prePersistUpdate() {
        // 遍历当前实体的所有集合字段
        Arrays.stream(this.getClass().getDeclaredFields())
                .filter(field -> Collection.class.isAssignableFrom(field.getType()))
                .forEach(field -> {
                    try {
                        field.setAccessible(true);
                        Collection<?> collection = (Collection<?>) field.get(this);
                        // 空集合转为Null
                        if (collection != null && collection.isEmpty()) {
                            field.set(this, null);
                        }
                    } catch (IllegalAccessException e) {
                        // 可替换为日志记录
                        e.printStackTrace();
                    }
                });
    }
}

让你的业务实体继承这个BaseEntity即可，Hibernate会在@PrePersist（首次保存）和@PreUpdate（更新）阶段自动执行转换逻辑，避免空集合触发Envers的modifiedFlags。

为什么这个方案更优 #

• 职责分离：JSON序列化和持久化逻辑各自用对应技术栈处理，避免耦合冲突
• 无副作用：保留Jackson默认反序列化逻辑，不会出现LinkedHashMap问题
• 自动化覆盖：无需手动初始化集合或修改业务代码，全局生效

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