Spring Boot/JPA中@OneToMany与@EmbeddedId引发懒加载初始化异常

一、核心映射问题：重复的关联配置 #

你的SecureToken实体存在重复的用户关联配置，这是导致关联错误和懒加载异常的根本原因：

• SecureTokenId嵌入类中已经通过@ManyToOne关联了UserAccount
• 同时SecureToken实体又单独定义了@ManyToOne的user字段并使用@MapsId("user_id")，这会造成映射冲突，Hibernate无法正确识别关联关系，进而导致双向关联失效、懒加载集合无法初始化。

修复方案：清理重复关联 #

修改SecureToken实体，移除单独的user字段，直接通过嵌入ID的tokenId.user维护关联：

@Entity
@Table(name = "secureToken", catalog = "useraccount")
public class SecureToken implements Serializable {
    @EmbeddedId
    public SecureTokenId tokenId = new SecureTokenId();

    @Column(unique = true)
    private String token;

    private Timestamp isConsumed;

    @CreationTimestamp
    @Column(updatable = false)
    private Timestamp timestamp;

    @Column(updatable = false)
    @Basic(optional = false)
    private Timestamp expireAt;

    // 移除重复的user关联字段及注解
    // @MapsId("user_id")
    // @JoinColumn(name = "user_id", referencedColumnName ="id")
    // @ManyToOne    
    // private UserAccount user;

    public SecureToken(UserAccount user, String token, String tokenType, Timestamp timestamp, Timestamp expire) {
        super();       
        this.token = token;       
        this.tokenId.setTokenType(tokenType);
        this.tokenId.setUser(user);
        this.timestamp = timestamp;
        this.expireAt = expire;      
        // 代码中未定义isExpired字段，需注释或补全
        // this.isExpired=false;        
    }

    // 新增方法从嵌入ID获取用户关联
    public UserAccount getUser() {
        return tokenId.getUser();
    }
}

同时修正SecureTokenId的equals和hashCode方法，避免依赖未初始化的懒加载对象：

@Embeddable
public class SecureTokenId implements Serializable {
    @Column(name="tokenType")
    private String tokenType;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id")
    private UserAccount user;

    // 构造方法、getter/setter保持不变

    @Override
    public boolean equals(Object o) {     
        if (o == null || getClass() != o.getClass())
            return false;    
        SecureTokenId that = (SecureTokenId) o;
        // 避免直接调用懒加载对象的getId()触发初始化异常
        return Objects.equals(tokenType, that.tokenType) &&
               Objects.equals(user != null ? user.getId() : null, that.user != null ? that.user.getId() : null);
    }

    @Override
    public int hashCode() {
        return Objects.hash(tokenType, user != null ? user.getId() : null);
    }
}

二、双向关联维护错误 #

在UserService中添加token到user时出错，是因为双向关联的维护逻辑不完整，需要确保双向关联同步，且操作在事务内完成：

修复UserAccount的关联添加方法 #

public class UserAccount implements Serializable {
    // 其他字段保持不变

    @OneToMany(mappedBy ="tokenId.user", cascade = {CascadeType.REMOVE, CascadeType.MERGE, CascadeType.REFRESH}, orphanRemoval =true, fetch=FetchType.LAZY)
    private Set<SecureToken> tokens = new HashSet<>();

    public void addSecureToken(SecureToken token) {
        this.tokens.add(token);
        // 确保token的嵌入ID指向当前用户
        if (token.getTokenId().getUser() != this) {
            token.getTokenId().setUser(this);
        }
    }

    // 其他getter/setter保持不变
}

修正Service层事务操作 #

确保整个关联流程在同一个事务内执行，避免脱离事务后触发懒加载异常：

// 在UserService的目标方法上添加@Transactional（若未添加）
@Transactional
public void createAndBindToken(UserAccount user, String type) {
    SecureToken token = secureTokenService.generateToken(user, type);       
    secureTokenService.save(token);      
    user.addSecureToken(token); 
    this.save(user);
}

三、懒加载异常的解决 #

修复映射问题后，Hibernate.initialize即可正常初始化懒加载集合，但必须在事务内调用：

@Transactional
public UserAccount getUserWithTokens(Long userId) {
    UserAccount user = userRepository.findById(userId).orElseThrow();
    // 事务内初始化懒加载集合
    Hibernate.initialize(user.getTokens());
    return user;
}

若特定场景下不需要懒加载，可临时将@OneToMany的fetch属性改为FetchType.EAGER，但不建议长期使用，会影响查询性能。

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