向User实体Set字段添加Business保存报错，CommandRunner执行正常

问题本质 #

你遇到的异常核心原因是：从数据库加载的User实例中，businesses字段是一个不可变集合，当JPA尝试执行集合修改操作（比如clear()）来维护关联关系时，不可变集合不支持这类操作，从而抛出UnsupportedOperationException。而CommandRunner中能正常运行，是因为你在那里直接创建的是可变集合（比如HashSet），而非JPA返回的不可变代理集合。

常见原因与解决办法 #

1. 实体类集合初始化使用了不可变实现

检查User实体类中businesses字段的初始化代码，如果用了Collections.emptySet()、Collections.unmodifiableSet()这类不可变集合实现，就会导致问题。

错误示例：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    // 不可变集合初始化，导致后续无法修改
    private Set<Business> businesses = Collections.emptySet();

    // getter、setter...
}

修正方案：
将集合初始化为可变实现，比如HashSet或LinkedHashSet：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private Set<Business> businesses = new HashSet<>();

    // getter、setter...
}

2. JPA懒加载返回不可变代理集合

如果实体类初始化没问题，但JPA懒加载时返回了不可变的集合代理（比如Hibernate的PersistentSet在某些场景下的限制），可以在修改集合前手动将其转换为可变集合。

业务层修正示例：

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public void addBusinessToUser(Long userId, Business newBusiness) {
        User user = userRepository.findById(userId).orElseThrow(() -> new RuntimeException("User not found"));
        
        // 将不可变集合转换为可变HashSet
        user.setBusinesses(new HashSet<>(user.getBusinesses()));
        user.getBusinesses().add(newBusiness);
        
        userRepository.save(user);
    }
}

3. 业务逻辑中误将集合转为不可变

检查业务代码中是否存在Collections.unmodifiableSet()这类操作，将可变集合转为不可变后返回给调用方，导致后续修改失败。如果有这类代码，需要移除或在修改前重新转为可变集合。

验证逻辑 #

CommandRunner中能正常运行，是因为你在那里直接创建了User实例并初始化了可变集合，没有经过JPA的代理加载流程，所以集合本身是可修改的。而从数据库加载的实例，集合是JPA生成的代理或不可变实现，因此无法执行修改操作。

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