Spring Boot中H2数据库ID列映射失败的问题求助

你遇到的核心问题是Hibernate期望使用名为address_seq的序列生成ID，但你的Flyway初始化脚本里并没有创建这个序列，导致Schema校验时抛出注解异常。下面给你几个符合JPA规范的根本解决方案，你可以根据业务需求选择：

方案一：使用序列生成ID（匹配Hibernate默认SEQUENCE策略） #

如果希望通过序列自动生成ID，需要两步配合操作：

1. 在Flyway脚本中创建address_seq序列
   修改初始化SQL，先创建序列再建表：

   CREATE SEQUENCE address_seq START WITH 1 INCREMENT BY 1;
   
   CREATE TABLE T_ADDRESS ( 
       ID BIGINT(19) PRIMARY KEY, 
       CREATION_TIME TIMESTAMP NOT NULL, 
       CREATED_BY VARCHAR(50) NOT NULL, 
       UPDATED_TIME TIMESTAMP NOT NULL, 
       UPDATED_BY VARCHAR(50) NOT NULL, 
       ADDRESS_LINE_1 VARCHAR(50) NOT NULL, 
       ADDRESS_LINE_2 VARCHAR(50), 
       ADDRESS_LINE_3 VARCHAR(50), 
       CITY VARCHAR(50) NOT NULL, 
       COUNTRY VARCHAR(7), 
       ZIP_CODE INTEGER(4) NOT NULL 
   );
   

2. 在实体类ID字段上明确配置序列生成器
   给@Id字段添加注解，指定序列名称和生成策略：

   @Entity
   @Table(name = "T_ADDRESS")
   public class AddressEntity extends PersistentEntity {
       @Id
       @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "address_seq")
       @SequenceGenerator(name = "address_seq", sequenceName = "address_seq", allocationSize = 1)
       private Long id;
       // 其他字段...
   }
   

   注意：allocationSize的值要和序列的INCREMENT BY保持一致，避免出现ID跳号或冲突问题。

方案二：使用自增列生成ID（更简洁的自增策略） #

如果不想依赖序列，H2支持自增列，配置更简单：

1. 修改Flyway建表脚本，将ID设为自增列

   CREATE TABLE T_ADDRESS ( 
       ID BIGINT(19) PRIMARY KEY AUTO_INCREMENT, 
       CREATION_TIME TIMESTAMP NOT NULL, 
       CREATED_BY VARCHAR(50) NOT NULL, 
       UPDATED_TIME TIMESTAMP NOT NULL, 
       UPDATED_BY VARCHAR(50) NOT NULL, 
       ADDRESS_LINE_1 VARCHAR(50) NOT NULL, 
       ADDRESS_LINE_2 VARCHAR(50), 
       ADDRESS_LINE_3 VARCHAR(50), 
       CITY VARCHAR(50) NOT NULL, 
       COUNTRY VARCHAR(7), 
       ZIP_CODE INTEGER(4) NOT NULL 
   );
   

2. 修改实体类ID字段的生成策略

   @Entity
   @Table(name = "T_ADDRESS")
   public class AddressEntity extends PersistentEntity {
       @Id
       @GeneratedValue(strategy = GenerationType.IDENTITY)
       private Long id;
       // 其他字段...
   }
   

方案三：手动指定ID（无需自动生成） #

如果业务逻辑中会手动给ID赋值，只需确保实体类的ID字段没有@GeneratedValue注解：

@Entity
@Table(name = "T_ADDRESS")
public class AddressEntity extends PersistentEntity {
    @Id
    private Long id;
    // 其他字段...
}

这种方式下，Hibernate不会尝试寻找任何ID生成器，只要你在保存实体前手动设置唯一的ID值即可。

额外注意事项 #

• 确保Flyway脚本执行顺序正确：若使用序列，序列创建脚本要在表创建脚本之前执行；
• 你的spring.jpa.hibernate.ddl-auto=validate配置会让Hibernate严格校验数据库Schema与实体映射的一致性，必须保证两者完全匹配；
• 检查是否存在全局JPA生成器配置（如配置类或XML文件中），避免默认生成器干扰当前实体的ID策略。

内容的提问来源于stack exchange，提问作者jactor-rises