Hibernate插入Null值异常：Spring Data ReST+Hibernate+PostgreSQL布尔字段问题

你遇到的这个问题很典型——明明客户端传了isActive的值，后端却始终拿到null，触发数据库非空约束异常。结合Spring Data REST、Jackson序列化规则和Hibernate的特性，我整理了几个最可能的原因和对应的解决方案：

1. Jackson默认序列化规则导致字段名不匹配 #

Java中以is开头的布尔类型字段，Jackson默认会把它序列化为去掉is、首字母小写的属性名（比如isActive会被处理成active）。如果你的REST客户端传入的是isActive，后端就无法正确映射到实体类的字段，最终导致字段值为null。

解决方案： #

在实体类的isActive字段（或其getter/setter）上添加@JsonProperty("isActive")注解，强制Jackson使用指定的字段名进行序列化和反序列化：

import com.fasterxml.jackson.annotation.JsonProperty;

// 实体类其他代码
private Boolean isActive;

@JsonProperty("isActive")
public Boolean getIsActive() {
    return isActive;
}

@JsonProperty("isActive")
public void setIsActive(Boolean isActive) {
    this.isActive = isActive;
}

2. Getter方法命名不符合JavaBean规范 #

布尔类型的标准getter方法应该是isActive()，而不是getIsActive()。如果你的getter方法命名错误，Spring Data REST的属性绑定逻辑会识别不到这个字段，自然无法绑定值。

解决方案： #

修改getter方法为布尔类型的标准形式，配合@JsonProperty注解使用：

// 正确的布尔类型getter
@JsonProperty("isActive")
public Boolean isActive() {
    return isActive;
}

// setter保持正常
@JsonProperty("isActive")
public void setIsActive(Boolean isActive) {
    this.isActive = isActive;
}

3. 字段被意外忽略或未暴露 #

如果你的实体类给isActive字段加了@JsonIgnore，或者Spring Data REST的@RestResource(exported = false)注解，会直接导致这个字段无法被客户端传入的值绑定。

解决方案： #

检查实体类的注解，确保没有排除isActive字段。如果需要主动暴露该字段，可以在字段或getter上添加：

import org.springframework.data.rest.core.annotation.RestResource;

@RestResource(exported = true)
private Boolean isActive;

4. 数据库字段与实体类类型不匹配 #

虽然你提到数据库字段是非空的，但要确认PostgreSQL中的字段类型是boolean（而非varchar或其他类型），同时实体类的isActive是Boolean包装类（如果是boolean基本类型，默认值是false，不会出现null的情况）。

验证方法： #

执行SQL查看表结构，确认字段类型：

\d your_table_name;

确保is_active字段类型为boolean且带有NOT NULL约束。

最后验证步骤 #

1. 用Postman或curl发送请求，确认请求体中的字段名和@JsonProperty指定的一致：

{
  "isActive": true,
  // 其他字段...
}

2. 在setIsActive方法中加日志或断点，查看是否有值传入：

public void setIsActive(Boolean isActive) {
    System.out.println("Received isActive value: " + isActive); // 调试用
    this.isActive = isActive;
}

3. 如果问题仍存在，检查Spring Data REST的全局配置，确保没有忽略布尔字段的规则。

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