JPA非varchar类型字段强制要求配置columnDefinition问题排查

核心根因 #

该问题是Hibernate默认类型映射规则被覆盖/失效导致，常见触发原因有3类：

1. JPA数据库方言配置错误/缺失，Hibernate无法识别当前使用的数据库类型，所有非显式指定类型的字段默认映射为varchar
2. 项目中存在配置了autoApply = true的自定义全局类型转换器，无差别覆盖了Hibernate默认的数值、布尔、日期等类型的转换逻辑
3. JPA注解包混用，同时导入了javax.persistence和jakarta.persistence两套注解，Hibernate无法正确解析字段类型定义

排查步骤 #

• 检查application.yml/application-dev.yml中JPA方言配置，确认与当前使用的数据库类型、版本完全匹配
• 全局搜索项目中所有带@Converter注解的类，排查是否存在启用了自动应用的泛型类型转换器
• 检查实体类所有JPA注解的导入路径，确认全部来自同一套JPA规范包
• 排查近期新增的JPA扩展依赖、JHipster/Spring Boot版本升级记录，确认是否有改写默认JPA配置的改动

解决方案 #

方言配置修正示例（以MySQL 8、javax规范为例） #

spring:
  jpa:
    hibernate:
      ddl-auto: none
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect

异常转换器处理 #

删除无意义的全局泛型转换器，或把转换器的autoApply属性改为false，仅在需要使用该转换逻辑的字段上通过@Convert注解手动指定。

注解包统一 #

根据项目依赖的JPA规范版本，统一所有实体类的注解导入源：JHipster 7及更低版本用javax.persistence，JHipster 8及更高版本用jakarta.persistence，不可混用。

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