Spring Data REST新增关联Organization的User时提示organizationId不能为空问题

核心原因 #

• 你在JSON中传递的organizationId没有对应User实体中的可反序列化字段：User实体仅声明了Organization类型的organization关联属性，没有可写的organizationId基础类型字段，Jackson反序列化时会直接忽略请求中的organizationId值，导致关联的organization属性为空，入库时触发外键非空报错。
• Spring Data REST默认规范不支持直接传递关联实体主键完成绑定，默认要求传递关联资源的URI来完成关联映射。
• 额外小提示：你提供的请求JSON示例中role字段末尾多了一个逗号，不符合JSON规范，实际请求时需要删掉避免解析报错。

解决方案（任选一种即可） #

方案1：遵循Spring Data REST默认规范修改请求格式 #

无需修改任何代码，仅调整POST请求的JSON结构，将organizationId字段替换为关联资源的URI：

{
    "firstName": "Test",
    "lastName": "User",
    "email": "user@example.com",
    "phoneNumber": "+12019582790",
    "organization": "/organizations/22bf93a5-e620-4aaf-8333-ad67391fb235",
    "password": "example123",
    "role": "admin"
}

注意：URI前缀需和你Organization实体暴露的REST接口路径一致，如你自定义了路径前缀需对应修改。

方案2：支持直接传递organizationId主键绑定 #

如果你不想修改请求格式，希望直接传ID完成关联，按以下步骤修改：

1. 给User实体的organization字段添加Jackson序列化/反序列化注解，支持直接通过ID映射关联实体：

@Entity
@Table(name="user")
public class User {
    @ManyToOne(targetEntity = Organization.class, fetch = FetchType.EAGER)
    @JoinColumn(name = "organizationId", nullable = false)
    @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "organizationId")
    @JsonIdentityReference(alwaysAsId = true)
    private Organization organization;
    
    // 可选：添加只读organizationId字段方便返回参数携带ID
    @Column(name = "organizationId", insertable = false, updatable = false)
    private UUID organizationId;

    // 省略其他属性和getter/setter
}

2. 修改请求JSON，将organizationId改为organization，值保持主键字符串即可：

{
    "firstName": "Test",
    "lastName": "User",
    "email": "user@example.com",
    "phoneNumber": "+12019582790",
    "organization": "22bf93a5-e620-4aaf-8333-ad67391fb235",
    "password": "example123",
    "role": "admin"
}

方案3：保留请求中的organizationId字段名无需修改 #

如果连请求参数的organizationId名称都不想改，直接在User实体中添加对应setter方法手动处理关联：

@Entity
@Table(name="user")
public class User {
    @ManyToOne(targetEntity = Organization.class, fetch = FetchType.EAGER)
    @JoinColumn(name = "organizationId", nullable = false)
    private Organization organization;

    // 省略其他属性
    
    // 新增setter处理请求中的organizationId字段
    @JsonProperty("organizationId")
    public void setOrganizationById(UUID organizationId) {
        this.organization = new Organization();
        this.organization.setOrganizationId(organizationId);
    }
}

注意：此方法依赖JPA的getReference能力，仅设置ID不会触发额外查询，关联数据校验正常触发。

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