Hibernate技术求助：username字段类型不匹配报错排查

核心矛盾是你的实体类username定义为String类型，但Hibernate执行SQL时检测到数据库对应字段为integer类型，哪怕你认为是字符串类型，大概率是实际表结构与预期不符或映射配置出错，按以下步骤排查：

• 第一步：确认数据库实际字段类型
  直接在数据库客户端执行查询查看表结构：

  SELECT column_name, data_type FROM information_schema.columns WHERE table_name = '你的表名';
  

  重点查看username字段的data_type，如果确实是integer，说明建表时配置错误，直接修改字段类型：

  ALTER TABLE 你的表名 ALTER COLUMN username TYPE VARCHAR(255);
  

  注意：如果字段已有数据，需确保数据可转换为字符串，或先备份数据再操作。

• 第二步：检查实体类的映射配置
  检查Kotlin实体类是否存在错误的JPA注解配置：比如是否误给username添加了@Column(columnDefinition = "integer")这类错误声明，或者字段名映射错误（比如将username关联到了其他integer类型字段）。
  正确的显式映射示例：

  @Column(name = "username", columnDefinition = "VARCHAR(255)")
  var username: String = ""
  

• 第三步：排查Hibernate自动建表逻辑
  若使用了spring.jpa.hibernate.ddl-auto配置（如update或create）：

  • update模式下Hibernate不会自动修改已有字段的类型，仅会新增字段或表；
  • 如果之前实体类username是Int类型，后续改为String，Hibernate不会自动更新数据库字段类型，需手动修改表结构，或在测试环境设置ddl-auto=create-drop（会清空数据）重新生成表。

• 第四步：确认数据库连接正确性
  检查应用配置文件（如application.properties/application.yml）中的数据库URL、用户名、密码，确保连接的是你预期的数据库实例，避免混淆测试库与开发库。

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