Spring Boot中User与Authority实体关联保存失败问题求助

问题原因 #

JPA双向一对多关联中，外键的维护权属于@ManyToOne标注的一方（即Authority实体）。当前请求反序列化生成的Authority对象中，user属性为null，而User实体的@OneToMany仅为反向关联，不会自动填充Authority的外键字段，导致插入Authority时user_id为null。

修复方案 #

1. 自动维护双向关联（推荐） #

修改User实体的setAuthorities方法，在设置权限集合时，自动为每个Authority关联当前User：

// User实体类中
public void setAuthorities(Set<Authority> authorities) {
    this.authorities = authorities;
    if (authorities != null) {
        authorities.forEach(authority -> authority.setUser(this));
    }
}

这样当User对象被设置权限集合时，每个Authority都会自动绑定当前User，Hibernate在保存时会正确填充user_id字段。

2. 手动在控制器中维护关联 #

如果不想修改实体类的set方法，也可以在保存User前，手动为每个Authority设置关联的User：

// RegistrationController的register方法
@PostMapping("/register")
public ResponseEntity<User> register(@RequestBody User userRequest){
    if (userRequest.getAuthorities() != null) {
        userRequest.getAuthorities().forEach(auth -> auth.setUser(userRequest));
    }
    User u = userRepo.save(userRequest);
    return new ResponseEntity<>(u, HttpStatus.CREATED);
}

3. 解决JSON循环引用问题（可选） #

双向关联直接返回User对象时，Jackson序列化会出现循环引用错误，可通过以下注解修复：

• 在User实体的authorities字段添加@JsonManagedReference：

@OneToMany(mappedBy="user",fetch=FetchType.EAGER, cascade = CascadeType.ALL)
@JsonManagedReference
private Set<Authority> authorities;

• 在Authority实体的user字段添加@JsonBackReference：

@ManyToOne
@JoinColumn(name = "user_id")
@JsonBackReference
private User user;

额外注意点 #

请求JSON中的mobileNumber是数字类型，但User实体中该字段定义为String，会导致反序列化异常，建议将请求中的mobileNumber改为字符串格式：

{
    "name": "aa",
    "email": "2aa@mail.com",
    "mobileNumber": "1999",
    "pwd": "password",
    "authorities": [        
        { "name": "ROLE_ADMIN"}
    ]
}

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