如何通过单条查询正确删除数据库记录？JPA关联实体场景

你遇到的问题本质是数据库外键约束：UserDetails的主键直接关联User的ID，删除User时，UserDetails仍持有该ID的引用，触发约束报错。下面是几种可行的解决方法：

方法1：通过JPA级联删除自动处理关联 #

修改User实体，添加对UserDetails的反向关联并配置级联删除，这样删除User时JPA会自动先删除对应的UserDetails：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    private long id;
    private String name;

    // 添加反向关联，配置级联删除
    @OneToOne(mappedBy = "user", cascade = CascadeType.REMOVE, fetch = FetchType.LAZY)
    private UserDetails userDetails;
}

之后直接调用userRepository.delete(user)，JPA会自动执行两条删除语句（先删UserDetails，再删User），无需手动处理。

方法2：用JPQL写批量删除语句（单条查询完成） #

如果不想修改实体映射，可以直接写JPQL语句，一次性删除关联的子实体和父实体：

@Modifying
@Query("DELETE FROM UserDetails ud WHERE ud.user.id = :userId")
void deleteUserDetailsByUserId(@Param("userId") long userId);

// 调用顺序：先删子实体，再删父实体
userDetailsRepository.deleteUserDetailsByUserId(userId);
userRepository.deleteById(userId);

也可以把两条删除逻辑封装在一个@Transactional方法里，保证操作的原子性。

方法3：修改数据库外键为ON DELETE CASCADE #

直接在数据库层面配置外键的级联删除规则，这样删除User时，数据库会自动删除对应的UserDetails：

ALTER TABLE user_details 
ADD CONSTRAINT fk_user_details_user 
FOREIGN KEY (id) REFERENCES user(id) 
ON DELETE CASCADE;

配置完成后，直接调用userRepository.delete(user)即可，数据库会自动处理关联删除，无需修改代码。

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