Hibernate操作PostgreSQL自增主键时序列查找失败求助

我来帮你搞定这个头疼的问题！之前我在处理多schema的PostgreSQL+Hibernate项目时也踩过类似的坑，给你几个针对性的排查和解决方向：

1. 先检查实体类的主键注解是否配置正确 #

这是最常见的问题点，一定要确保注解里同时指定了schema和序列的正确信息。举个正确的配置例子：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "my_seq_generator")
@SequenceGenerator(
    name = "my_seq_generator",
    sequenceName = "my_sequence", // 这里是序列的纯名称，不带schema
    schema = "apiprofile", // 单独指定序列所属的schema
    allocationSize = 1 // 建议设为1，避免和PostgreSQL序列步长不匹配的问题
)
private Long id;

⚠️ 注意：@GeneratedValue里的generator要和@SequenceGenerator的name完全一致，而sequenceName不要加schema前缀，单独用schema参数指定才是正确的姿势。

2. 确认数据库用户对序列有访问权限 #

很多时候会忽略权限问题，Hibernate使用的数据库用户可能没有apiprofile schema下序列的USAGE权限。执行这条SQL给用户授权：

GRANT USAGE ON SEQUENCE apiprofile.my_sequence TO your_database_user;

如果权限不足，哪怕序列确实存在，Hibernate也会直接报找不到序列的错误。

3. 配置Hibernate默认schema减少重复代码 #

如果你的大部分表和序列都在apiprofile schema下，可以在Hibernate配置里设置默认schema，这样每个实体类就不用重复写schema参数了：

# Spring Boot项目在application.properties中配置
spring.jpa.properties.hibernate.default_schema=apiprofile

# 原生Hibernate在hibernate.cfg.xml中配置
<property name="hibernate.default_schema">apiprofile</property>

配置后，实体类的序列注解就可以简化成：

@SequenceGenerator(name = "my_seq_generator", sequenceName = "my_sequence", allocationSize = 1)

4. 验证数据库里的序列和表关联是否正确 #

先确认序列真的在apiprofile schema下，执行这条SQL查询：

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

如果找不到序列，先手动创建：

CREATE SEQUENCE apiprofile.my_sequence START WITH 1 INCREMENT BY 1;

另外，如果是手动建的表，要确保主键列默认值关联了这个序列：

CREATE TABLE apiprofile.my_table (
    id BIGINT PRIMARY KEY DEFAULT nextval('apiprofile.my_sequence'),
    -- 其他列定义...
);

最后一招：开启SQL日志排查实际执行语句 #

如果上面的方法都没用，开启Hibernate的SQL日志，看看它实际生成的SQL里nextval()调用是不是带了正确的schema前缀：

# 开启SQL日志
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

正常情况下应该看到nextval('apiprofile.my_sequence')，如果是nextval('my_sequence')，说明还是schema没配置对，回到第一步检查注解配置。

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