Spring Boot关联表数据未保存：外键为null的原因排查

1. 维护方未关联被关联对象 #

LoginUser作为关联维护方，必须在保存前将RegisteredUser实例赋值给LoginUser的关联字段，否则JPA无法触发级联保存。

// 错误示例：未关联RegisteredUser
LoginUser loginUser = new LoginUser();
RegisteredUser registeredUser = new RegisteredUser();
// 缺少 loginUser.setRegisteredUser(registeredUser);
userRepository.save(loginUser);

// 正确示例
LoginUser loginUser = new LoginUser();
RegisteredUser registeredUser = new RegisteredUser();
loginUser.setRegisteredUser(registeredUser); // 关键：维护方绑定被关联对象
userRepository.save(loginUser);

2. 双向关联未同步反向引用 #

如果是双向@OneToOne关联（RegisteredUser中也持有LoginUser字段），仅维护方绑定还不够，必须同步设置RegisteredUser的LoginUser引用，否则JPA可能无法正确识别关联关系：

LoginUser loginUser = new LoginUser();
RegisteredUser registeredUser = new RegisteredUser();
loginUser.setRegisteredUser(registeredUser);
registeredUser.setLoginUser(loginUser); // 同步反向关联
userRepository.save(loginUser);

3. 注解配置错误 #

检查@OneToOne的配置是否搞反了维护方：

• 维护方（LoginUser）不能加mappedBy属性，mappedBy是标注在被维护方的，用来指定由另一方维护关联。如果错误给LoginUser的@OneToOne加了mappedBy，会导致LoginUser失去维护权，级联保存失效。
• 维护方需要用@JoinColumn指定外键字段，匹配数据库中的fk_reUserID：

// 正确配置：LoginUser作为维护方
@Entity
public class LoginUser {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToOne(cascade = CascadeType.ALL)
    @JoinColumn(name = "fk_reUserID") // 指定数据库外键字段名
    private RegisteredUser registeredUser;
    // getter/setter
}

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

    // 双向关联时，被维护方用mappedBy指定维护方字段
    @OneToOne(mappedBy = "registeredUser")
    private LoginUser loginUser;
    // getter/setter
}

4. 请求参数未正确绑定 #

检查接口接收的请求数据是否正确映射到实体关联字段：

• 前端提交的JSON必须包含嵌套的RegisteredUser数据，比如：

{
    "username": "testUser",
    "registeredUser": {
        "email": "test@example.com",
        "phone": "13800138000"
    }
}

• 确保实体类的关联字段有对应的setter方法，避免参数绑定失败导致关联对象为null。

5. 事务未配置 #

JPA的级联操作必须在事务上下文执行，确保保存接口的方法上添加了@Transactional注解：

@Service
public class UserService {
    @Autowired
    private LoginUserRepository loginUserRepository;

    @Transactional // 必须添加，保证级联操作在事务中完成
    public LoginUser saveLoginUser(LoginUser loginUser) {
        return loginUserRepository.save(loginUser);
    }
}

内容的提问来源于stack exchange，提问作者sunith p pathirana