Spring Data JPA设置字段长度后仍报varchar(255)长度溢出错误

• Hibernate字段映射未正确识别配置：@Column(length = 100000) 的长度属性解析依赖Hibernate方言配置，若方言不匹配（比如使用了与当前数据库不对应的方言、旧版本方言），Hibernate会忽略自定义length，默认将String类型字段映射为varchar(255)。你遇到的报错本质是Hibernate层面的参数校验触发的，还没到实际操作物理表的阶段，所以哪怕物理表字段长度更大，甚至改成TEXT类型，还是会收到255长度超限的提示。
• 存在额外的校验逻辑：如果字段上添加了@Size(max = 255)、@Length(max = 255)这类JSR校验注解，会在数据持久化前先触发校验，和物理表的字段长度无关。
• Hibernate元数据缓存未更新：修改实体类注解后如果没有重启应用，或者开启了Hibernate二级缓存，旧的255长度元数据会被缓存，导致校验逻辑仍沿用旧规则。日志中的HHH000099断言错误，就是Hibernate内部缓存的字段元数据和实际物理表结构不匹配导致的。
• 关联实体同名字段配置错误：如果存在关联实体也有description字段且配置长度为255，持久化关联操作时也会触发该错误。

1. 修正字段映射配置
   优先使用columnDefinition显式指定字段类型，比单独配置length兼容性更强：
   如果要使用TEXT类型：

@Lob
@Column(columnDefinition = "TEXT")
private String description;

如果要保留varchar(100000)类型：

@Column(columnDefinition = "varchar(100000)")
private String description;

2. 检查Hibernate方言配置
   确认application.properties/yml中的方言配置和你使用的数据库完全匹配，例如PostgreSQL要配置对应版本的方言：

spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect

3. 排查额外校验注解
   删除description字段上多余的长度校验注解，或者将注解的max值调整为符合业务需求的长度。
4. 清除缓存重启应用
   修改完配置后彻底重启应用，清除Hibernate的元数据缓存，确保新的实体配置生效。
5. 排查关联实体配置
   检查所有关联的实体类，确认同名字段的长度配置是否正确。

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