Hibernate/Jackson序列化：如何处理Getter中的懒加载集合异常？

我有一个基于Spring/Hibernate的REST API，使用Jackson将对象序列化为JSON。现有Company实体类的基础配置如下：

public class Company implements Serializable {
    
    @OneToMany(mappedBy = "company")
    private List<Party> parties = new ArrayList<>();

    ...
}

我已在Spring配置中安装Hibernate5Module，当parties集合未初始化时，不会被纳入JSON映射，这符合我的预期：

mapperBuilder.modulesToInstall(
    new Hibernate5Module()
);

但如果为Company类添加一个调用parties的getter方法getPrimaryAddress()，该方法内部会抛出懒加载异常，导致Spring无法生成JSON响应：

public class Company implements Serializable {
    
    @OneToMany(mappedBy = "company")
    private List<Party> parties = new ArrayList<>();

    public Party getPrimaryAddress() {
        return this.parties == null ? null : this.parties.stream()
            .filter(party -> AddressType.PRIMARY_ADDRESS.equals(party.getAddressType()))
            .findAny()
            .orElse(null);
    }
}

我不想在该getter中添加Hibernate.isInitialized判断，因为这会影响JPA事务内的服务层。请问是否有办法忽略或处理getter/访问器中的懒加载异常？

方法1：用Jackson注解控制序列化 #

如果getPrimaryAddress()仅在事务内业务逻辑中使用，序列化时不需要输出该字段，直接用@JsonIgnore标记方法即可：

@JsonIgnore
public Party getPrimaryAddress() {
    // 原有逻辑
}

如果需要在特定场景下序列化，可结合@JsonInclude(JsonInclude.Include.NON_NULL)，但这仅能控制非空值序列化，需配合其他方式解决懒加载问题。

方法2：自定义序列化器捕获懒加载异常 #

针对getPrimaryAddress()方法的返回值自定义序列化器，捕获懒加载异常并返回null：

public class PrimaryAddressSerializer extends JsonSerializer<Party> {
    @Override
    public void serialize(Party value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        try {
            // 正常序列化逻辑
            gen.writeObject(value);
        } catch (LazyInitializationException e) {
            // 懒加载触发异常时返回null
            gen.writeNull();
        }
    }
}

然后在方法上标记使用该序列化器：

@JsonSerialize(using = PrimaryAddressSerializer.class)
public Party getPrimaryAddress() {
    // 原有逻辑
}

方法3：扩展Hibernate5Module全局处理 #

Hibernate5Module默认仅处理实体关联字段的懒加载，对自定义getter方法的异常无处理。可以扩展该模块，全局捕获序列化时的懒加载异常：

public class CustomHibernate5Module extends Hibernate5Module {
    @Override
    protected void setupModule(SetupContext context) {
        super.setupModule(context);
        context.addBeanSerializerModifier(new BeanSerializerModifier() {
            @Override
            public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) {
                for (BeanPropertyWriter writer : beanProperties) {
                    // 为每个属性 writer 添加异常捕获逻辑
                    JsonSerializer<Object> originalSerializer = writer.getSerializerInstance(config, beanDesc);
                    writer.assignSerializer(new JsonSerializer<>() {
                        @Override
                        public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
                            try {
                                originalSerializer.serialize(value, gen, serializers);
                            } catch (LazyInitializationException e) {
                                gen.writeNull();
                            }
                        }
                    });
                }
                return beanProperties;
            }
        });
    }
}

之后在Spring配置中替换原有模块：

mapperBuilder.modulesToInstall(
    new CustomHibernate5Module()
);

方法4：服务层提前初始化或计算结果 #

在返回Company对象到REST层之前，在事务内提前初始化parties集合或调用getPrimaryAddress()，让结果被缓存，避免序列化时触发懒加载：

// 服务层方法，运行在事务内
public Company getCompanyById(Long id) {
    Company company = companyRepository.findById(id).orElseThrow();
    // 方式1：初始化关联集合
    Hibernate.initialize(company.getParties());
    // 方式2：提前调用方法，缓存结果
    company.getPrimaryAddress();
    return company;
}

这种方式无需修改实体类或序列化配置，将懒加载处理放在服务层，不影响其他业务逻辑。

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