Spring+JPA登录报错：无法懒加载User.roles集合的解决咨询

从你的错误日志和代码来看，这个问题的核心是Hibernate懒加载机制导致的Session缺失：当UserDetailsServiceImpl从仓库获取User对象后，数据库Session已经关闭，此时再去访问user.getRoles()（懒加载集合）就会触发InternalAuthenticationServiceException，因为没有Session来初始化这个代理集合。

下面给你几个可行的修复方案，你可以根据自己的项目情况选择：

方案1：修改实体类的关联加载策略 #

把User类中roles字段的@ManyToMany注解改成立即加载（FetchType.EAGER），这样查询用户时会一次性把关联的角色数据加载进来，避免后续懒加载的问题：

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

优点：代码改动最小，直接在实体类上配置即可。
缺点：如果用户关联的数据量很大（比如后续还有其他关联集合），立即加载会导致查询性能下降，因为每次查用户都会加载所有关联数据。

方案2：在Repository层使用JOIN FETCH强制关联查询 #

在UserRepository中定义一个带JOIN FETCH的查询方法，确保查询用户时同时加载角色数据，在Session关闭前就把需要的所有数据都获取到：

首先，在UserRepository接口中添加方法：

public interface UserRepository extends JpaRepository<User, Integer> {
    @Query("SELECT u FROM User u JOIN FETCH u.roles WHERE u.username = :username")
    User findByUsernameWithRoles(@Param("username") String username);
}

然后修改UserDetailsServiceImpl中的代码，调用这个新方法：

@Override
public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
    User user = userRepository.findByUsernameWithRoles(username);
    
    if (user == null) {
        throw new UsernameNotFoundException("User not found with username: " + username);
    }

    Set<GrantedAuthority> grantedAuthorities = new HashSet<>();
    for (Role role : user.getRoles()) {
        grantedAuthorities.add(new SimpleGrantedAuthority(role.getRole()));
    }

    return new org.springframework.security.core.userdetails.User(user.getUsername(), user.getPassword(), grantedAuthorities);
}

优点：精准控制需要加载的关联数据，只在需要的时候加载角色，性能更优。
缺点：需要额外编写Repository查询方法，适合对性能有要求的场景。

方案3：给loadUserByUsername方法添加事务注解 #

在UserDetailsServiceImpl的loadUserByUsername方法上添加@Transactional注解，让整个方法运行在同一个数据库Session中，这样懒加载集合时Session还处于打开状态：

@Service
public class UserDetailsServiceImpl implements UserDetailsService {

    @Autowired
    private UserRepository userRepository;

    @Override
    @Transactional
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        User user = userRepository.findByUsername(username);
        
        if (user == null) {
            throw new UsernameNotFoundException("User not found with username: " + username);
        }

        Set<GrantedAuthority> grantedAuthorities = new HashSet<>();
        for (Role role : user.getRoles()) {
            grantedAuthorities.add(new SimpleGrantedAuthority(role.getRole()));
        }

        return new org.springframework.security.core.userdetails.User(user.getUsername(), user.getPassword(), grantedAuthorities);
    }
}

优点：不需要修改实体类或Repository代码，只需要添加一个注解，适合快速解决问题。
缺点：事务会覆盖整个方法执行过程，如果方法中有其他数据库操作，可能会影响事务边界，不过登录场景下一般没问题。

另外，提醒你注意：在你的UserDetailsServiceImpl中最好添加user == null的判断，避免空指针异常，我上面的代码已经补上了这个判断。

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