如何在Hibernate构建时字节码增强中使用代理？

针对你使用Spring Boot 2.7.5 + Hibernate 5.6.12.Final，通过hibernate-enhance-maven-plugin构建时增强后懒加载关联无代理的问题，可通过以下方案解决：

1. 调整字节码增强插件配置 #

修改pom.xml中的hibernate-enhance-maven-plugin配置，同时启用延迟初始化增强、关联管理增强和脏跟踪，确保生成支持代理的字节码逻辑：

<plugin>
    <groupId>org.hibernate.orm.tooling</groupId>
    <artifactId>hibernate-enhance-maven-plugin</artifactId>
    <version>5.6.12.Final</version>
    <executions>
        <execution>
            <phase>process-classes</phase>
            <goals>
                <goal>enhance</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <failOnError>true</failOnError>
        <!-- 启用懒加载字节码增强 -->
        <enableLazyInitialization>true</enableLazyInitialization>
        <!-- 启用关联管理，支持代理逻辑 -->
        <enableAssociationManagement>true</enableAssociationManagement>
        <!-- 启用脏跟踪，保证Hibernate实体状态管理正常 -->
        <enableDirtyTracking>true</enableDirtyTracking>
    </configuration>
</plugin>

2. 为关联字段显式指定代理模式 #

对需要懒加载且保留代理的关联（如@OneToOne），添加@LazyToOne(LazyToOneOption.PROXY)注解，强制Hibernate使用代理实现懒加载：

@Entity
public class YourEntity {
    @OneToOne(fetch = FetchType.LAZY)
    @LazyToOne(LazyToOneOption.PROXY)
    private RelatedEntity relatedEntity;

    // getter/setter 省略
}

该注解会覆盖字节码增强的默认直接加载行为，确保返回代理对象。

3. 验证Hibernate代理工厂配置 #

在application.properties（或application.yml）中确认代理工厂类配置正确，保证代理机制生效：

# 使用Hibernate 5.6默认的ByteBuddy代理工厂
hibernate.proxy.factory_class=org.hibernate.proxy.bytebuddy.ByteBuddyProxyFactory
# 启用反射优化器，兼容字节码增强逻辑
hibernate.bytecode.use_reflection_optimizer=true

4. MapStruct适配备选方案 #

若上述配置仍无法满足需求，可直接在MapStruct映射器中通过Hibernate API判断关联是否初始化，无需依赖代理：

@Mapper(componentModel = "spring")
public interface YourEntityMapper {
    YourDto toDto(YourEntity entity);

    @BeforeMapping
    default void handleLazyAssociations(YourEntity entity) {
        if (entity != null) {
            // 判断关联是否已初始化，未初始化则在会话内手动触发加载
            if (!Hibernate.isInitialized(entity.getRelatedEntity())) {
                Hibernate.initialize(entity.getRelatedEntity());
            }
        }
    }
}

Hibernate.isInitialized()方法对字节码增强后的实体同样有效，可直接判断关联的加载状态，避免LazyInitializationException。

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