Hibernate实体ActivityField的required属性返回true与数据库false值不符

排查与解决方案 #

1. 检查实体类映射与Getter逻辑 #

• 确认ActivityField.java中required字段的@Column注解配置正确，name属性与数据库实际字段名完全匹配，没有拼写错误，也没有配置错误的columnDefinition参数
• 检查isRequired() getter方法是否存在自定义逻辑，很多开发者会在getter中加入额外的关联判断，导致返回值与数据库存储的字段值不一致
• 确认字段类型没有混用：如果使用基本类型boolean，注意未赋值的默认值为false，如果使用包装类Boolean，要确认没有初始化赋值为true，也没有同时存在isRequired()和getRequired()两个getter方法导致Hibernate取值逻辑冲突

2. 排查Hibernate缓存问题 #

你描述的「修改数据库后刷新页面值仍然不对」的表现高度符合缓存问题：

• 临时在查询逻辑前加入entityManager.clear()清空当前会话的一级缓存，再执行查询看返回值是否正确
• 如果你开启了Hibernate二级缓存，给查询方法加上@Cacheable(false)注解，或者在查询时加入提示强制刷新缓存：

TypedQuery<ActivityField> query = entityManager.createQuery("select a from ActivityField a", ActivityField.class);
query.setHint("javax.persistence.cache.storeMode", CacheStoreMode.REFRESH);

• 确认没有配置全局的字段默认值拦截器，在对象实例化时强制给required字段赋值为true

3. 验证关联查询的影响 #

即使没有自定义DISTINCT查询，如果ActivityField与其他实体存在一对多、多对多关联，默认的关联抓取逻辑可能导致对象属性被错误覆盖：

• 单独调用repository.findById()查询出问题的单条记录，直接打印isRequired()的返回值，如果单条查询结果正确，说明是列表查询时的关联fetch逻辑导致的属性覆盖，可以通过设置@Fetch(FetchMode.SELECT)或者关闭关联的默认抓取解决
• 打开Hibernate SQL打印配置，确认查询返回的字段原始值是否正确：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql=TRACE

如果日志打印的required字段值为0（对应false）但对象返回true，就是实体映射问题；如果日志打印的值为1（对应true），说明你查询的数据源和你查看的数据库不是同一个，检查配置文件中的数据库连接地址、账号是否正确。

4. 关键词冲突排查 #

required是很多框架的关键词，你可以临时将字段改名为isObligatoire，同步修改数据库字段名和getter方法，如果问题消失就是关键词冲突导致的映射异常。

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