MySQL迁移PostgreSQL时Hibernate序列表字段类型不匹配问题

一、定位Hibernate自动生成的序列及关联实体 #

• 直接查询PostgreSQL数据库中的序列：
  执行SQL语句：

  SELECT sequence_name FROM information_schema.sequences WHERE sequence_schema = 'public';
  

  Hibernate自动生成的序列通常命名为hibernate_sequence（全局通用序列）或[实体类名]_seq（实体专属序列）。
• 通过SQL日志关联实体：
  在配置文件中开启SQL打印：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

  执行触发序列调用的业务操作，查看日志中nextval('xxx_seq')的序列名，对应到使用该序列的实体类（实体主键通常用@GeneratedValue(strategy = GenerationType.SEQUENCE)注解）。

二、修复布尔字段类型不匹配错误 #

1. 全局配置（批量解决） #

在application.properties或application.yml中添加Hibernate方言配置，强制将布尔类型映射为PostgreSQL的smallint：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
# Hibernate 5.x及以上版本用这个配置
spring.jpa.properties.hibernate.type.preferred_boolean_type=smallint
# 部分新版本Hibernate可能需要这个
spring.jpa.properties.hibernate.type.default_for_boolean=smallint

2. 实体字段级注解（精准处理） #

如果全局配置不生效，直接在实体的布尔字段上添加注解，无需纠结序列对应的表——序列仅负责主键生成，布尔字段属于实体属性，对应数据库表字段：

import org.hibernate.annotations.Type;
import javax.persistence.Column;

// ...
@Column(columnDefinition = "smallint")
@Type(type = "org.hibernate.type.NumericBooleanType")
private Boolean isEnabled;

同时确保数据库对应字段为smallint类型，若原字段是boolean，执行表结构修改：

ALTER TABLE your_table_name ALTER COLUMN your_boolean_column TYPE smallint USING your_boolean_column::integer;

3. 排查关联实体的布尔字段 #

找到序列对应的实体后，检查该实体及其关联的所有子实体、关联实体中的布尔字段，确保所有字段的映射规则统一，避免触发持久化时出现类型不兼容。

三、额外注意事项 #

• 若项目使用实体继承，需检查父类、子类的布尔字段是否都做了正确映射
• 若开启了Hibernate自动建表（spring.jpa.hibernate.ddl-auto=update），可能存在旧表结构未更新的情况，可在测试环境临时改为create重建表，或用Flyway/Liquibase做结构化迁移

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