如何清理Hibernate缓存或Jpa Repository？解决实体字段删除后列自动恢复问题

原因分析 #

Hibernate的update模式仅会根据实体类定义新增或修改表字段，不会主动删除数据库中存在但实体类已移除的字段。而手动删除列后偶尔自动恢复，通常是以下情况导致：

• 代码存在隐性引用：JPQL/HQL查询硬编码了price字段、动态查询（如Specification、Criteria API）仍在使用该字段，Hibernate启动时解析这些逻辑会误判实体类需要该字段，从而自动重建；
• 多实体映射同一张表：如果有其他实体类（比如继承子类、或不同实体指定了同一张表）还保留price属性，Hibernate会依据这些实体定义重建字段；
• 缓存未清理：Hibernate元数据缓存、应用服务器类加载缓存未清空，导致启动时加载了旧的实体类定义。

解决方法 #

• 彻底排查代码引用
  • 全局搜索项目中所有包含price的JPQL、原生SQL语句，删除或修正相关引用；
  • 检查动态查询逻辑（如Specification、CriteriaBuilder代码），确保不再使用price字段；
  • 确认所有映射到该表的实体类（包括继承结构中的子类）都已移除price属性。
• 清理缓存
  • 重启应用前清空应用服务器缓存目录（如Tomcat的work目录）；若使用Spring Boot DevTools，关闭应用后删除.spring-boot-devtools.properties或重启IDE清除缓存；
  • 若开启了Hibernate二级缓存，清空对应缓存存储（如Redis、Ehcache的缓存数据）。
• 临时锁定表结构修改
  • 先将application.properties中的spring.jpa.hibernate.ddl-auto改为none，重启应用后手动删除数据库中的price列；确认删除完成后，再根据需求改回update（或长期保持none，后续表结构变更手动操作）。
• 长期规范建议
  • 生产环境避免使用update模式管理表结构，改用Flyway、Liquibase这类数据库迁移工具，通过版本化SQL脚本精准控制每一次结构变更，彻底规避Hibernate自动DDL带来的意外问题。

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