Java REST服务PUT请求报null PK错误排查求助（Angular6）

嘿，我之前也碰到过一模一样的情况——更新接口突然报主键为空的500错误，而且只有特定对象出问题，同类业务代码却正常。咱们一步步拆解问题：

核心报错定位 #

你看到的java.lang.IllegalArgumentException: find操作传入了null主键，本质是后端在执行更新前的查询（find）操作时，拿到的主键值是null，导致JPA的entityManager.find()直接抛出异常。

按优先级排查的几个方向 #

1. 先从GlassFish堆栈信息找触发点 #

先看堆栈里的业务代码行，比如：

Caused by: java.lang.IllegalArgumentException: Primary key cannot be null
at com.yourpackage.YourService.findById(YourService.java:72)

找到这行代码后，确认是哪段逻辑传了null主键——比如是Controller直接把URL里的id传进来，还是从请求体的实体里取的id？对比正常业务的Service代码，看主键的获取方式是否一致。

2. 检查后端PUT接口的主键接收逻辑 #

比如你的Controller代码可能是这样的：

@PutMapping("/yourentity")
public ResponseEntity<YourEntity> update(@RequestBody YourEntity entity) {
    // 这里如果调用service.findById(entity.getId())，而entity.getId()是null就会报错
    YourEntity existing = yourService.findById(entity.getId());
    // ... 更新逻辑
}

对比正常运行的业务接口：

• 正常接口是不是把主键放在URL路径里？比如@PutMapping("/normalentity/{id}")，用@PathVariable Long id接收？
• 还是正常接口的实体类主键能被正确映射，而这个报错的实体类漏了注解？

检查报错实体类的主键注解：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
// 有没有少@Id？或者字段名和前端传的不一致？比如前端传的是"entityId"，后端是"id"，没加@JsonProperty("entityId")

3. 排查前端Angular的PUT请求构造 #

这是最容易出问题的地方！对比正常业务的前端更新代码：

// 正常的更新请求：把主键拼在URL里
updateNormalEntity(entity: NormalEntity): Observable<NormalEntity> {
  return this.http.put<NormalEntity>(`/api/normalentity/${entity.id}`, entity);
}

看你报错的请求是不是漏了主键：

// 错误示例：URL里没带id，或者entity.id本身是null
updateYourEntity(entity: YourEntity): Observable<YourEntity> {
  return this.http.put<YourEntity>(`/api/yourentity`, entity);
}

另外检查前端表单：有没有绑定主键字段？比如编辑页面是不是漏了隐藏的id输入框：

<!-- 正常表单会绑定主键，确保提交时带上 -->
<input type="hidden" [(ngModel)]="yourEntity.id" name="id">

如果表单没绑定，编辑时entity的id就会是null，传到后端自然触发报错。

4. 对比正常业务代码的差异 #

把正常运行的PUT接口和报错的接口做逐行对比：

• 后端：URL结构、参数接收方式、Service调用逻辑
• 前端：请求URL构造、实体对象的字段完整性、表单绑定逻辑
  差异点大概率就是问题所在。

快速修复建议 #

• 如果是前端漏传URL主键：修改Angular请求，把entity.id拼到URL路径里，后端用@PathVariable接收
• 如果是前端实体id为null：在编辑表单中添加隐藏的id绑定，确保提交时实体携带主键
• 如果是后端映射问题：给实体类主键字段加上正确的@Id注解，或者用@JsonProperty匹配前端字段名
• 如果是Service层逻辑错误：对比正常Service的find调用方式，调整主键传入逻辑

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