Spring中使用ModelMapper映射Hibernate懒加载实体时关联集合为null如何解决

Hibernate的懒加载关联属性（包括集合、实体对象）会被封装为代理实例，未触发初始化时，实体类对应的底层字段值为null，只有调用对应getter方法访问属性内容时，才会触发代理的初始化逻辑，从数据库加载数据并填充到字段中。
ModelMapper默认启用字段匹配策略，会直接通过反射读取实体类的字段值，不会调用属性的getter方法，因此读取到的是未初始化的null值。你当前使用的空遍历方案本质是主动触发代理初始化，让字段被赋值后再进行映射，所以可以正常拿到数据。

• 方案1：引入Hibernate专用适配模块（最省心）
  ModelMapper官方提供了Hibernate适配模块，可自动识别并处理Hibernate代理对象、懒加载集合的初始化逻辑，无需手动修改映射规则。
  操作步骤：

1. 引入依赖（以Maven为例）

<dependency>
    <groupId>org.modelmapper</groupId>
    <artifactId>modelmapper-module-hibernate</artifactId>
    <version>和你当前使用的ModelMapper版本保持一致</version>
</dependency>

2. 注册模块到ModelMapper实例

modelMapper.registerModule(new HibernateModule());

注册后即可直接正常映射，无需额外处理。

• 方案2：调整ModelMapper访问策略为Getter优先
  修改ModelMapper配置，关闭字段匹配，启用公共方法（Getter/Setter）匹配，这样映射时会调用属性的getter方法，自动触发懒加载代理的初始化：

modelMapper.getConfiguration()
    // 关闭直接字段匹配
    .setFieldMatchingEnabled(false)
    // 允许访问公共方法
    .setMethodAccessLevel(AccessLevel.PUBLIC)
    // 配置属性匹配策略优先匹配Getter/Setter
    .setMatchingStrategy(MatchingStrategies.STANDARD);

这个方案无需额外引入依赖，适合不想加多余依赖的场景。

• 方案3：自定义懒加载集合转换器
  如果需要更灵活的控制（比如未初始化的懒加载集合直接返回null而非触发查询），可以自定义针对Hibernate PersistentCollection 类型的转换器：

Converter<PersistentCollection, Object> hibernateCollectionConverter = context -> {
    PersistentCollection collection = context.getSource();
    // 仅当集合已初始化时才转换，否则返回null
    if (Hibernate.isInitialized(collection)) {
        return context.getSource();
    }
    return null;
};
modelMapper.addConverter(hibernateCollectionConverter);

所有映射操作必须在Hibernate有效的Session/事务范围内执行，否则触发懒加载时会抛出LazyInitializationException异常。如果映射逻辑在事务外执行，需要先在持久层通过JOIN FETCH等方式提前加载需要映射的关联属性。

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