Spring Boot双向一对一关联中PhoneNumber的Person属性为null问题

1. 修正实体类的关联映射配置 #

核心问题大概率出在JPA关联映射的配置上，因为PhoneNumber的person_id同时作为主键和外键，需要用@MapsId注解绑定Person的主键，确保关联关系正确。

Person实体 #

@Entity
@Table(name = "person")
public class Person {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "person_id")
    private Long personId;
    
    private String name;
    
    private Integer age;

    // 必须有无参构造函数
    public Person() {}

    // 全参构造函数、getter/setter方法
}

PhoneNumber实体 #

@Entity
@Table(name = "phone_number")
public class PhoneNumber {
    @Id
    @Column(name = "person_id")
    private Long personId; // 主键，同时作为外键关联Person的person_id
    
    @OneToOne
    @MapsId // 该注解会让当前实体的主键与关联实体的主键保持一致
    @JoinColumn(name = "person_id", referencedColumnName = "person_id")
    private Person person;
    
    private String phoneNumber; // 自定义电话号码字段，可根据需求调整

    // 必须有无参构造函数
    public PhoneNumber() {}

    // 全参构造函数、getter/setter方法
}

2. 调整JSON请求格式 #

根据业务场景选择对应的JSON格式：

• 场景1：同时创建Person和PhoneNumber
  需要在JSON中嵌套Person对象，确保Jackson能正确反序列化关联关系：

  {
      "person": {
          "name": "张三",
          "age": 25
      },
      "phoneNumber": "13800138000"
  }
  

• 场景2：关联已存在的Person
  直接传递已有的personId即可，无需嵌套Person对象：

  {
      "personId": 1,
      "phoneNumber": "13800138000"
  }
  

3. 控制器的正确处理逻辑 #

控制器中需要先处理Person的持久化（如果是新创建的），再关联到PhoneNumber，避免外键约束错误，同时保证person字段不为null：

@RestController
@RequestMapping("/api")
public class PhoneNumberController {
    private final PersonRepository personRepository;
    private final PhoneNumberRepository phoneNumberRepository;

    // 构造函数注入（推荐替代@Autowired）
    public PhoneNumberController(PersonRepository personRepository, PhoneNumberRepository phoneNumberRepository) {
        this.personRepository = personRepository;
        this.phoneNumberRepository = phoneNumberRepository;
    }

    @PostMapping("/phone-numbers")
    public PhoneNumber createPhoneNumber(@RequestBody PhoneNumber phoneNumber) {
        // 如果传入的Person是新的（无主键），先保存Person
        if (phoneNumber.getPerson() != null && phoneNumber.getPerson().getPersonId() == null) {
            Person savedPerson = personRepository.save(phoneNumber.getPerson());
            phoneNumber.setPerson(savedPerson);
            phoneNumber.setPersonId(savedPerson.getPersonId());
        }
        return phoneNumberRepository.save(phoneNumber);
    }
}

4. 其他排查点 #

• 确保实体类有无参构造函数，Jackson和JPA都依赖它完成对象实例化。
• 检查Jackson配置：如果JSON用下划线命名（如person_id），需要在application.properties中开启驼峰转下划线：

  spring.jackson.property-naming-strategy=SNAKE_CASE
  

• 验证数据库表结构：启动应用后，检查phone_number表的person_id字段是否同时被标记为主键和外键，关联到person表的person_id。

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