PostgreSQL中无需显式指定序列生成实体ID的实现方法

问题原因 #

当你使用@GeneratedValue(strategy = GenerationType.SEQUENCE)时，JPA（以Hibernate为例）会默认尝试查找名为{表名}_seq的序列——也就是你的场景下会找table_name_seq，但你实际创建的序列是test_seq，所以会抛出找不到序列的错误。

无需显式指定生成器的实现方式 #

方式1：修改序列名称匹配JPA默认规则 #

直接把自定义序列test_seq重命名为JPA默认期望的table_name_seq，这样JPA就能自动匹配到序列，无需在实体类中指定生成器。

执行SQL修改序列名称：

ALTER SEQUENCE test_seq RENAME TO table_name_seq;

修改后你的实体类代码保持不变即可正常运行：

@Table(name = "table_name")
public class TestEntity {
  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE)
  private Long id;

  private String name;
}

方式2：自定义全局序列命名策略（不推荐，影响范围广） #

如果不想修改现有序列名称，可以通过自定义Hibernate的PhysicalNamingStrategy来指定序列名称规则，但这种方式是全局生效的，会影响所有使用SEQUENCE策略的实体类，仅适合所有表都使用统一非默认序列命名规则的场景。

示例实现（仅作参考）：

public class CustomSequenceNamingStrategy extends PhysicalNamingStrategyStandardImpl {
    @Override
    public Identifier toPhysicalSequenceName(Identifier name, JdbcEnvironment context) {
        // 针对table_name表，返回test_seq作为序列名
        if ("table_name".equals(name.getText())) {
            return Identifier.toIdentifier("test_seq");
        }
        // 其他表沿用默认规则
        return super.toPhysicalSequenceName(name, context);
    }
}

然后在Hibernate配置中指定该策略：

spring.jpa.hibernate.naming.physical-strategy=com.yourpackage.CustomSequenceNamingStrategy

总结 #

最简洁且无副作用的方式是修改序列名称匹配JPA默认规则，这样既不用修改实体类代码，也能正常使用@GeneratedValue(strategy = GenerationType.SEQUENCE)自动生成ID。

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