Spring Boot 的 JPA save() 方法依据主键判断是插入还是更新；直接修改 ID 后调用 save() 会被视为新增记录。若需真正更新主键值，必须绕过 JPA 的默认行为，推荐使用原生 SQL 更新语句或手动删除+重建。
spring boot 的 jpa `save()` 方法依据主键判断是插入还是更新；直接修改 id 后调用 `save()` 会被视为新增记录。若需真正更新主键值，必须绕过 jpa 的默认行为，推荐使用原生 sql 更新语句或手动删除+重建。
在标准 JPA 实践中，主键（如 activityId）一旦生成，就不应被修改——这不仅违背数据库设计原则（主键应稳定、不可变），也与 JPA 的持久化上下文机制冲突。你当前的 @PutMapping("/activity/{id}") 接口逻辑存在一个关键误区：它从 URL 路径中提取旧 ID（{id}），但又直接将请求体中的新 activityId 赋值给 Activity 对象，随后调用 activityRepo.save(activity)。此时 JPA 检测到传入对象的主键（activityId）与当前 Session 中无对应托管实体，且该主键值（如 "0033"）在数据库中尚不存在，因此执行 INSERT 而非 UPDATE，导致“看似更新实则新增”。
✅ 正确解决方案（推荐）：使用原生 SQL 执行字段级更新
在 ActivityRepository 中添加自定义更新方法，绕过 JPA 的实体生命周期管理：
@Repository
public interface ActivityRepository extends JpaRepository<Activity, String> {
@Modifying
@Query(nativeQuery = true,
value = "UPDATE activity SET activity_id = :newId WHERE activity_id = :oldId")
@Transactional
int updateActivityId(@Param("newId") String newId, @Param("oldId") String oldId);
}⚠️ 注意事项：
- @Modifying 是必需的，用于标识该查询会修改数据；
- @Transactional 确保操作在事务中执行（否则抛出异常）；
- 表名和字段名需与数据库实际结构一致（示例中假设表为 activity，字段为 activity_id；若实体字段名为 activityId 且启用 spring.jpa.hibernate.naming.physical-strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy，通常映射为下划线命名）；
- 返回值 int 表示影响行数，可用于校验是否成功更新。
对应调整 Controller，使其调用该方法而非 save()：
@PutMapping("/activity/{oldId}")
public ResponseEntity<Void> updateActivityId(
@PathVariable String oldId,
@RequestBody Map<String, String> payload) {
String newId = payload.get("activityId");
if (newId == null || newId.trim().isEmpty()) {
return ResponseEntity.badRequest().build();
}
int updated = activityRepo.updateActivityId(newId, oldId);
if (updated == 0) {
return ResponseEntity.notFound().build();
}
return ResponseEntity.ok().build();
}? Postman 请求示例：
- Method: PUT
- URL: http://localhost:8080/activity/0001
-
Body → raw (JSON):
{ "activityId": "0033" }
❌ 替代方案（不推荐）：先 deleteById(oldId) 再 save(newActivity)
虽可行，但存在并发风险（如中间有其他读请求获取到已删未建的数据）、违反原子性，且无法保证外键引用完整性，仅适用于完全隔离的测试场景。
? 总结：
主键变更属于数据库底层操作，不应依赖 JPA 的声明式持久化逻辑。生产环境中应避免修改主键；若因历史原因必须支持，请统一通过 @Query(nativeQuery = true) + @Modifying 实现，并严格校验参数合法性与业务约束。
