Spring JPA TableGenerator验证冲突：Hibernate为何期望VARCHAR类型？

错误根源 #

1. 实体类与主键类的ID类型不匹配 #

实体类Project中projId是Long类型，但主键类ProjectPk中对应的projId是int类型，类型不一致会导致Hibernate映射时的类型解析混乱，是潜在的核心问题之一。

2. @TableGenerator配置与数据库表结构不匹配 #

Hibernate的@TableGenerator默认会将pkColumnName对应的列映射为VARCHAR类型——因为pkColumnValue是字符串值（你设置的是"proj_id"），Hibernate默认认为这一列是用来存储序列标识键的字符串列。但你创建的project_id表中，proj_id列被设为bigint类型，和Hibernate期望的类型直接冲突，这就是触发验证错误的直接原因。

另外你的project_id表缺少表生成器必需的「序列值存储列」，这会导致序列生成逻辑无法正常工作。

修复步骤 #

1. 修正主键类的类型匹配 #

修改ProjectPk类中projId的类型为Long，与实体类保持完全一致：

public class ProjectPk implements java.io.Serializable {
    private Long projId; // 从int改为Long
    private int version;

    // 同步更新构造方法、equals、hashcode、getter和setter的类型
}

2. 调整表生成器的数据库表结构 #

修正Flyway迁移文件中的project_id表，添加序列值存储列，并将序列标识键列设为VARCHAR类型：

drop table if exists project_id;
CREATE TABLE project_id
(
    proj_id VARCHAR(255) NOT NULL, -- 存储序列标识的键名，用VARCHAR
    next_val BIGINT NOT NULL, -- 存储下一个序列值的列
    PRIMARY KEY (proj_id)
) ENGINE=InnoDB;
-- 初始化序列起始值
INSERT INTO project_id (proj_id, next_val) VALUES ('proj_id', 1);

3. 修正实体类的@TableGenerator配置 #

明确指定序列值存储列，匹配数据库表结构：

@Id
@GeneratedValue(strategy=GenerationType.TABLE, generator="nextProjectId")
@TableGenerator(
        name="nextProjectId",
        table="project_id",
        pkColumnName = "proj_id",
        pkColumnValue="proj_id",
        valueColumnName = "next_val", // 指定存储序列值的列
        initialValue = 1,
        allocationSize = 1
)
private Long projId;

4. 验证一致性 #

确保所有相关配置的类型完全对齐：

• 实体类Project的projId：Long
• 主键类ProjectPk的projId：Long
• project表的proj_id列：bigint
• project_id表的next_val列：bigint（存储序列值）、proj_id列：varchar（存储序列标识键）

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