JPA映射PostgreSQL IDENTITY生成序列报缺失的解决方法

你遇到的序列找不到问题由三个核心问题导致：

• 注解配置存在低级错误：@GeneratedValue和@SequenceGenerator中配置的生成器名称、序列名称末尾带了多余的尾随空格（代码里写的是"action_id_seq "，末尾多了一个空格），和数据库中实际无空格的序列名action_id_seq无法匹配。
• Schema名称大小写不匹配：PostgreSQL中未加双引号包裹的标识符会默认自动转为小写存储，你查询出的序列所在schema是小写common，但注解里配置的schema是大写"COMMON"，Hibernate会按大写schema名查找，自然找不到对应序列。
• 额外隐藏问题：你当前表的ID列是GENERATED ALWAYS AS IDENTITY模式，数据库自动生成的序列是IDENTITY列的内部专属序列，默认不允许外部直接调用nextval取值，就算名称匹配成功，后续插入数据时也会报权限错误。

1. 修正实体类注解配置，删除所有名称配置的尾随空格，将schema名改为和数据库一致的小写：

   @Id
   @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "action_id_seq")
   @SequenceGenerator(
           name = "action_id_seq",
           sequenceName = "action_id_seq",
           allocationSize = 1,
           schema = "common"
   )
   @Column(name = "ID", nullable = false, insertable = false)
   private Integer id;
   

2. 放开IDENTITY列的序列调用权限，执行如下SQL修改列生成规则，允许外部手动调用序列取值：

   ALTER TABLE common.action ALTER COLUMN id SET GENERATED BY DEFAULT;
   

   如果你不想修改原有IDENTITY配置，也可以单独创建一个供JPA使用的独立序列，将注解中的sequenceName指向新序列即可：

   -- 创建独立序列，起始值和当前表最大ID保持一致即可
   CREATE SEQUENCE common.action_jpa_id_seq START WITH 1 INCREMENT BY 1;
   -- 给项目使用的数据库账号分配序列读写权限
   GRANT USAGE, SELECT ON SEQUENCE common.action_jpa_id_seq TO 你的项目数据库用户名;
   

3. 性能优化配置：如果使用批量插入需要提升性能，可以将allocationSize调大（比如设置为50），同时将对应序列的自增步长改为相同值，减少序列查询的网络交互：

   -- 以allocationSize=50为例
   ALTER SEQUENCE common.action_id_seq INCREMENT BY 50;
   

修复完成后重启项目，schema校验就可以正常通过，SEQUENCE策略可以正常支持批量插入操作。

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