本文详解 Spring Boot 中更新 API 遇到非空字段（如 DOB）报错的根源及解决方案，并指导如何将多个 @RequestBody 合并为单一 DTO，兼顾数据库约束、API 契约清晰性与代码健壮性。
本文详解 spring boot 中更新 api 遇到非空字段（如 dob）报错的根源及解决方案，并指导如何将多个 `@requestbody` 合并为单一 dto，兼顾数据库约束、api 契约清晰性与代码健壮性。
在构建 RESTful 更新接口时，一个常见但易被忽视的问题是：数据库字段设为 NOT NULL，而前端仅传递需修改的字段（如跳过 dob），后端却直接全量覆盖实体属性，导致未传字段被设为 null，最终触发 SQL 约束异常。你遇到的 Column 'dob' cannot be null 错误正是这一典型场景——UPDATE 操作本应支持“部分更新”，但当前逻辑误将其当作“全量替换”。
✅ 根本原因分析
-
@RequestBody OrgPatient orgPatient绑定的 JSON 若不包含"dob"字段，Jackson 默认反序列化为null（假设dob是LocalDate或Date类型）； - 服务层直接调用
updatedUser.setDob(orgPatient.getDob())，将null写入实体； - JPA/Hibernate 执行
save()时生成UPDATE ... SET dob = ?，参数为null，违反 MySQL 的NOT NULL约束。
✅ 正确做法：空值跳过更新（推荐）
绝不盲目覆盖，只更新客户端显式提供的字段：
// 在 service 方法中，对每个可选字段做 null 检查
if (orgPatient.getFirstName() != null) {
updatedUser.setFirstName(orgPatient.getFirstName());
}
if (orgPatient.getLastName() != null) {
updatedUser.setLastName(orgPatient.getLastName());
}
if (orgPatient.getDob() != null) { // ? 关键修复：仅当传了 DOB 才更新
updatedUser.setDob(orgPatient.getDob());
}
if (orgPatient.getGender() != null) {
updatedUser.setGender(orgPatient.getGender());
}
// 同理处理 PatientContact 字段
if (patientContact.getContactNumberType() != null) {
updatedContactUser.setContactNumberType(patientContact.getContactNumberType());
}
if (patientContact.getContactNumer() != null) {
updatedContactUser.setContactNumer(patientContact.getContactNumer());
}
// ... 其他字段同理? 进阶建议：可封装为工具方法或使用
BeanUtils.copyProperties()配合自定义PropertyEditor/Converter，但手动判空更可控、可读性更强。
✅ 合并多个 @RequestBody：定义聚合 DTO
Spring MVC 不支持一个请求中绑定多个 @RequestBody（HTTP 请求体只有一个），你当前的 Controller 写法会导致启动失败或 400 错误。正确方式是创建一个组合 DTO：
// 新建统一请求体 DTO
public class PatientUpdateRequest {
private String firstName;
private String middleName;
private String lastName;
private LocalDate dob; // 可为 null，表示不更新
private String gender;
private String contactNumberType;
private String contactNumer;
private String contactAreaCode;
// 构造函数、getter/setter 省略
}Controller 改写为：
@PutMapping("/update/{patientId}")
public ResponseEntity<String> updatePatient(
@PathVariable String patientId,
@RequestBody PatientUpdateRequest request) { // ✅ 单一请求体
String result = updateOrgPatientService.updatePatient(patientId, request);
return ResponseEntity.ok(result);
}Service 层适配：
public String updatePatient(String patientId, PatientUpdateRequest request) {
Patient existing = patientRepository.findByPatientId(patientId);
if (existing == null) {
throw new IllegalArgumentException("Patient not found: " + patientId);
}
OrgPatient orgPatient = orgPatientRepository.findByOrgPatientId(patientId);
PatientContact contact = patientContactRepository.findByPatientId(patientId);
// 更新 OrgPatient（空值跳过）
if (request.getFirstName() != null) orgPatient.setFirstName(request.getFirstName());
if (request.getLastName() != null) orgPatient.setLastName(request.getLastName());
if (request.getDob() != null) orgPatient.setDob(request.getDob()); // ? 安全更新
// ... 其他字段
// 更新 PatientContact
if (request.getContactNumer() != null) contact.setContactNumer(request.getContactNumer());
// ... 其他字段
orgPatientRepository.save(orgPatient);
patientContactRepository.save(contact);
return "updated";
}⚠️ 注意事项与最佳实践
-
数据库设计反思：若
dob确实允许为空（如用户暂未提供），应将数据库字段改为NULL，并在实体类用@Column(nullable = true)显式声明； - API 文档明确约定：在 Swagger/OpenAPI 中注明各字段为 optional，并说明“未提供即保持原值”；
-
避免
@Transactional范围过大：确保save()操作在事务内，但不要包裹无关逻辑； -
考虑 PATCH 语义：对部分更新，更符合 REST 规范的是使用
PATCH /patient/{id}，并搭配 JSON Patch 或自定义更新 DTO。
通过以上改造，你的更新接口将具备：
- ✅ 空值安全：不因缺失字段触发数据库约束异常；
- ✅ 接口简洁：单请求体、单 DTO、职责清晰；
- ✅ 易于维护：字段更新逻辑集中、可测试、可扩展。
