保存JWT至RefreshToken表时触发TransientObjectException问题求助

错误原因 #

这个错误的核心是：保存RefreshToken时，Hibernate检测到关联的User对象里的Role实例是未持久化的临时对象（transient instance），而当前User与Role的ManyToMany关联只配置了CascadeType.REMOVE，没有配置级联持久化/合并的规则，导致Hibernate无法自动处理这些Role实例的状态。

修复方案 #

方案1：调整级联策略 #

修改User类中roles字段的@ManyToMany注解，添加CascadeType.MERGE（如果需要支持新增角色也可加上CascadeType.PERSIST）：

@ManyToMany(cascade = {CascadeType.REMOVE, CascadeType.MERGE}, fetch = FetchType.EAGER)
@JoinTable(name = "users_roles",
    joinColumns = @JoinColumn(name = "user_id", referencedColumnName = "user_id"),
    inverseJoinColumns = @JoinColumn(name = "role_id", referencedColumnName = "role_id"))
private Set<Role> roles;

这样当保存RefreshToken触发User的持久化操作时，Hibernate会自动合并关联的Role实例，避免临时对象的问题。

方案2：确保User实例处于持久化状态 #

在保存RefreshToken之前，务必保证关联的User是从数据库中查询到的持久化实例，而不是手动构造的对象或DTO转换后的对象。比如登录逻辑中，应该通过userRepository.findById(userId)或类似方法获取User，而不是直接创建新的User对象并设置roles。

方案3：避免 detached 状态的Role #

如果你的登录逻辑中使用了DTO转换，比如将User转换为UserDTO后又转回User对象，此时User里的Role会处于detached状态。这种情况下，需要先通过roleRepository.findById(roleId)重新加载Role的持久化实例，再设置到User的roles集合中，再关联到RefreshToken。

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