Hibernate一对多关联外键expert_id未保存问题求助

使用Spring Data JPA + PostgreSQL构建数据模型，Expert与PhoneNumber是一对多关系，但保存后Phone_number表的expert_id字段始终为空，返回的响应中PhoneNumber对象的expert属性也为null。

相关代码与配置 #

数据库表结构 #

CREATE TABLE Expert (
    expert_id INT PRIMARY KEY,
    first_name VARCHAR(50),
    last_name VARCHAR(50),
    email VARCHAR(100),
    join_date DATE,
    subscription_expiry_date DATE,
    is_specialist BOOLEAN,
    is_premium BOOLEAN,
    description TEXT,
    photo TEXT
);

CREATE TABLE Phone_number (
    id INT PRIMARY KEY,
    expert_id INT,
    phone_number VARCHAR(20),
    FOREIGN KEY (expert_id) REFERENCES Expert(expert_id)
);

实体类代码 #

Expert.java

@Entity
@Table(name = "expert")
public class Expert {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "expert_id")
    private Long expertId;

    // 其他简单字段

    @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "expert")
    @Column(name = "phoneNumber") // 此处存在错误
    private Set<PhoneNumber> phoneNumbers;

    // Getters, setters
}

PhoneNumber.java

@Entity
@Table(name = "phone_number")
public class PhoneNumber {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Integer id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "expert_id", referencedColumnName = "expert_id")
    private Expert expert;

    @Column(name = "phone_number")
    private String phoneNumber;

    // Getters, setters
}

服务层代码 #

@Service
public class ExpertService {

    @Autowired
    private ExpertRepository expertRepository;

    public List<Expert> getExperts() {
        return expertRepository.findAll();
    }

    public Optional<Expert> getExpert(Long id) {
        return expertRepository.findById(id);
    }

    public void saveOrUpdateExperts(List<Expert> experts) {
        expertRepository.saveAll(experts);
    }

    public Expert saveOrUpdateExpert(Expert expert) {
        return expertRepository.save(expert);
    }
}

请求与响应示例 #

请求参数：

{
    "expertId": 1,
    "phoneNumbers": [
        {
            "phoneNumber": "123-456-7890"
        },
        {
            "phoneNumber": "555-555-5555"
        }
    ]
}

响应结果：

{
    "expertId": 1,
    "phoneNumbers": [
        {
            "id": 2,
            "expert": null,
            "phoneNumber": "555-555-5555"
        },
        {
            "id": 1,
            "expert": null,
            "phoneNumber": "123-456-7890"
        }
    ]
}

问题原因与解决方法 #

1. 双向关联未维护拥有方关系 #

JPA双向一对多关联中，mappedBy = "expert"指定了PhoneNumber是关联关系的拥有方（外键字段expert_id在Phone_number表中），只有拥有方的关联属性被设置时，外键才会被更新。

当前代码仅在Expert中添加了phoneNumbers集合，但没有给每个PhoneNumber对象设置对应的expert属性，导致JPA无法识别两者的关联关系。

修复方法：在保存Expert时，遍历其phoneNumbers集合，手动设置每个PhoneNumber的expert属性：

public Expert saveOrUpdateExpert(Expert expert) {
    if (expert.getPhoneNumbers() != null && !expert.getPhoneNumbers().isEmpty()) {
        expert.getPhoneNumbers().forEach(phoneNumber -> phoneNumber.setExpert(expert));
    }
    return expertRepository.save(expert);
}

2. 移除@OneToMany上的错误@Column注解 #

@Column是用于映射数据库普通字段的注解，不能用在@OneToMany关联属性上，这个多余的注解会干扰JPA的关联映射逻辑。

修复方法：删除Expert类中phoneNumbers字段上的@Column(name = "phoneNumber")：

@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "expert")
private Set<PhoneNumber> phoneNumbers;

3. 解决响应中expert为null的序列化问题 #

PhoneNumber的expert字段使用了FetchType.LAZY懒加载，序列化时（比如返回JSON响应），懒加载的代理对象未被初始化，会被序列化为null。同时双向关联还可能导致循环序列化问题。

修复方法：使用Jackson的双向序列化注解处理：

• 在Expert的@OneToMany注解上添加@JsonManagedReference（主动引用，序列化时显示关联集合）
• 在PhoneNumber的@ManyToOne注解上添加@JsonBackReference（被动引用，序列化时忽略该属性，避免循环）

修改后的实体类代码片段：

Expert.java

@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "expert")
@JsonManagedReference
private Set<PhoneNumber> phoneNumbers;

PhoneNumber.java

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "expert_id", referencedColumnName = "expert_id")
@JsonBackReference
private Expert expert;

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