在 Java Web 开发中，当 POJO 字段声明为基本类型（如 int）时，缺失字段会被自动设为默认值（如 0），导致无法区分“未传值”与“传了 0”。解决方案是改用包装类型 Integer，使其可为 null，从而准确识别字段是否存在。
在 java web 开发中，当 pojo 字段声明为基本类型（如 `int`）时，缺失字段会被自动设为默认值（如 0），导致无法区分“未传值”与“传了 0”。解决方案是改用包装类型 `integer`，使其可为 `null`，从而准确识别字段是否存在。
要可靠判断 JSON 请求中某个整型字段（如 age）是否被客户端显式提供，绝不可使用基本类型 int —— 因为 Jackson 在反序列化时会将缺失字段自动初始化为 0，与用户主动传 "age": 0 完全无法区分。
✅ 正确做法：将字段及 getter/setter 均改为包装类型 Integer：
public class EmployeeRequest {
private Integer age; // 注意：使用 Integer 而非 int
private String name;
// getter 和 setter 也必须匹配 Integer 类型
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}此时，若请求体为：
{ "name": "smith" }则 employeeRequest.getAge() 返回 null，明确表示该字段未提供；
若请求体为：
{ "name": "smith", "age": 25 }则 getAge() 返回 25；
若为：
{ "name": "smith", "age": 0 }则返回 0 —— 真实语义清晰无歧义。
立即学习“Java免费学习笔记（深入）”；
⚠️ 注意事项：
- 不要混用类型（如
int字段 +Stringgetter），这违反 JavaBean 规范，Jackson 无法正确绑定，且会导致编译错误或运行时异常； -
@NotNull等校验注解对int无效（因永远不为 null），但对Integer有效，可配合@Valid使用； - 若需兼容前端传字符串数字（如
"age": "25"），需额外配置 Jackson 的DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY或自定义反序列化器，但标准场景下不推荐——应由 API 文档约定数值类型； - 数据库映射时，JPA/Hibernate 对
Integer的null支持天然友好，便于表达“未知年龄”。
总结：用 Integer 替代 int 是轻量、标准、零侵入的解决方案，既保持类型安全，又赋予字段“存在性语义”，是 REST API 设计中的最佳实践之一。
