使用@GeneratedValue+Hibernate+CockroachDB触发SQLGrammarException问题求助

我之前处理过类似的CockroachDB和Hibernate ID生成兼容性问题，结合你的测试结果（无生成ID时两者正常，有生成ID时PostgreSQL正常但CockroachDB报错），可以确定问题出在ID生成策略的兼容性差异上，下面给你详细分析和解决办法：

问题原因 #

CockroachDB虽然宣称兼容PostgreSQL，但在自增/生成ID的底层实现上有本质区别：

• PostgreSQL的自增列（SERIAL/BIGSERIAL）依赖序列，并且支持lastval()函数来获取最近生成的ID；
• CockroachDB的分布式架构决定了它不支持lastval()这类会话级的函数，同时它的GENERATED AS IDENTITY列实现和PostgreSQL的逻辑不一致，而Hibernate默认的GenerationType.IDENTITY策略会尝试调用lastval()，这就直接导致了SQL语法错误（SQLGrammarException）。

解决办法 #

根据你的需求，推荐以下几种解决方案，按优先级排序：

1. 改用UUID作为主键（最推荐） #

CockroachDB对UUID的支持非常友好，天生适配分布式场景，而且Hibernate可以自动生成UUID，完全避开数值型ID的兼容性问题。示例代码：

import java.util.UUID
import javax.persistence.*

@Entity
data class YourEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    val id: UUID = UUID.randomUUID(), // 初始值不影响，Hibernate会自动生成
    // 其他业务字段示例
    val name: String
)

同时确保你的application配置中使用正确的CockroachDB方言：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.CockroachDB232Dialect
# 根据你的CockroachDB版本调整，比如旧版本用CockroachDB201Dialect

2. 使用序列生成策略（如果坚持用数值型ID） #

如果必须使用Long/Int类型的ID，需要显式指定序列生成策略，并适配CockroachDB的分布式序列特性：

import javax.persistence.*

@Entity
@SequenceGenerator(
    name = "your_entity_seq",
    sequenceName = "your_entity_sequence",
    allocationSize = 1 // CockroachDB的序列是分布式的，必须设置allocationSize=1，否则会出现ID冲突
)
data class YourEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "your_entity_seq")
    val id: Long = 0,
    val name: String
)

这种方式下，Hibernate会调用CockroachDB支持的序列操作语法，避免触发不兼容的lastval()调用。

3. 手动分配ID（特殊场景适配） #

如果以上两种方式都不适合，你可以手动利用CockroachDB的unique_rowid()函数生成ID，在保存实体前手动设置：

// 保存前通过JDBC模板生成ID
val entityId = jdbcTemplate.queryForObject("SELECT unique_rowid()", Long::class.java)
val entity = YourEntity(id = entityId, name = "test")
entityRepository.save(entity)

这种方式需要自己处理ID生成逻辑，适合有特殊业务要求的场景。

验证步骤 #

1. 替换ID生成策略后，修改application配置中的Hibernate方言为对应版本的CockroachDB方言；
2. 确保使用最新的CockroachDB JDBC驱动（更新pom.xml/build.gradle中的依赖版本）；
3. 重新运行测试，确认SQLGrammarException不再出现。

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