如何在Java Spring Boot中通过DTO更新Entity数据？

我正在开发一个Web服务器项目，定义了如下Person实体类：

@Entity
public class Person {

    @Id
    @Column(name = "id")
    @GeneratedValue(strategy = GenerationType.AUTO, generator = "person_gen")
    @GenericGenerator(name = "person_gen", strategy = "native")
    private Integer id;


    @Past
    @DateTimeFormat(pattern = "dd.MM.yyyy")
    @Column(name = "date_of_birth", columnDefinition = ColumnDefinition.DATE)
    private LocalDate dateOfBirth;
}

为适配HTML表单将LocalDate转为字符串，我编写了DTO及Person与PersonDTO的双向转换器。

我的业务流程是：

1. 用户发起GET请求获取封装为DTO的Person数据并编辑；
2. 编辑后的数据通过POST传回服务器；
3. 服务器接收DTO并转换为Person实体。

但调用对应service/repository的save方法时会产生重复条目，我希望更新所有编辑过的字段。我尝试编写如下自定义更新方法：

@Query("UPDATE Person p SET ... WHERE p.id = :id")
void updateAllFields(@Param(value = "id") Integer id,...);

但该方法也无效。请问如何实现更新？是否缺少相关注解？

一、为什么save会产生重复条目？ #

当你从DTO转换出Person实体时，这个对象处于游离状态（未被JPA持久化上下文管理）。JPA执行save时的判断逻辑是：如果实体id为null则执行插入；如果id存在但上下文没有对应持久化对象，依然会判定为新对象执行插入，这就是重复数据产生的原因。

二、正确的更新方式 #

方式1：先查询再合并（推荐，符合JPA规范） #

在service层先通过id从数据库查询出处于持久化状态的Person对象，再将DTO中的字段值复制到该对象上，最后调用save方法。此时JPA会自动检测对象的属性变化，执行更新而非插入：

// Service层代码示例
public Person updatePerson(PersonDTO dto) {
    // 查询出数据库中已存在的持久化Person对象
    Person existingPerson = personRepository.findById(dto.getId())
            .orElseThrow(() -> new RuntimeException("未找到对应Person记录"));
    // 将DTO的字段值复制到持久化对象（可使用BeanUtils或手动赋值）
    existingPerson.setDateOfBirth(dto.getDateOfBirth());
    // 其他需要更新的字段同理
    // 调用save，此时JPA会执行更新操作
    return personRepository.save(existingPerson);
}

方式2：修复自定义@Query更新方法 #

你的自定义更新方法无效，通常是缺少两个关键注解：

1. @Modifying：告诉JPA这是一条修改类SQL语句，而非查询语句；
2. @Transactional：修改操作必须在事务内执行（若service层已加事务，repository层可省略，但添加更稳妥）。

修改后的repository方法示例：

@Modifying
@Transactional
@Query("UPDATE Person p SET p.dateOfBirth = :dateOfBirth WHERE p.id = :id")
void updateAllFields(@Param("id") Integer id, @Param("dateOfBirth") LocalDate dateOfBirth);

注意：这种方式直接执行数据库更新，不会触发JPA的实体生命周期回调（如@PreUpdate），也不会同步持久化上下文的对象状态，适合批量更新或不需要生命周期回调的场景。

三、额外注意事项 #

• 确保DTO转换为Person时，正确赋值了id字段，这是JPA判断对象是否为已存在记录的核心依据；
• 检查Spring MVC对表单日期参数的绑定是否正确，避免dateOfBirth字段为null导致更新异常；
• 确认你的DTO转换器完整复制了所有需要更新的字段，避免遗漏。

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