PostgreSQL序列起始值设置异常：Spring Boot迁移脚本问题求助

在Spring Boot应用中使用迁移脚本管理数据库：

1. 初始创建序列脚本：

CREATE SEQUENCE IF NOT EXISTS public.sequence_user START WITH 4 INCREMENT BY 5;

2. 后续迁移文件插入3条用户数据并尝试重置序列：

INSERT INTO public.user (id, first_name, last_name, username, "password") VALUES (1, 'John', 'Doe', 'johndoe', '...');
INSERT INTO public.user (id, first_name, last_name, username, "password") VALUES (2, 'Frank', 'James', 'frank', '...');
INSERT INTO public.user (id, first_name, last_name, username, "password") VALUES (3, 'Foo', 'Bar', 'foo', '...');
ALTER SEQUENCE sequence_user RESTART;
UPDATE public.user SET id = DEFAULT;

3. 建表语句补充：

CREATE SEQUENCE IF NOT EXISTS public.sequence_user START WITH 1 INCREMENT BY 5;
CREATE TABLE public."user"(
    id BIGINT NOT NULL,
    first_name VARCHAR(50) NOT NULL,
    last_name VARCHAR(50) NOT NULL,
    username VARCHAR(20) NOT NULL,
    password VARCHAR(100) NOT NULL,
    CONSTRAINT pk_user PRIMARY KEY (id)
);

运行应用新增用户时，ID从0、1开始并抛出主键冲突错误，需要让序列从4开始生成数值。

1. 表字段未关联序列：建表时id字段未设置默认值为序列的nextval，导致UPDATE public.user SET id = DEFAULT无意义，Spring Boot新增数据时也不会自动使用序列值。
2. 序列重置错误：ALTER SEQUENCE sequence_user RESTART会将序列重置为初始值（建表时为1），而非预期的4。
3. ORM配置缺失：Spring Boot实体类未正确配置序列生成策略，导致框架尝试使用自增（IDENTITY）方式生成ID，与序列逻辑冲突。

1. 关联表ID字段与序列 #

执行以下SQL，确保user表的id字段默认使用序列的下一个值：

ALTER TABLE public."user" ALTER COLUMN id SET DEFAULT nextval('public.sequence_user');

2. 正确重置序列到起始值4 #

使用指定起始值的重置语句，让序列下一次生成的数值为4：

ALTER SEQUENCE public.sequence_user RESTART WITH 4;

如果需要基于现有数据的最大ID动态设置（比如后续插入更多手动ID），可以使用setval函数：

-- 第三个参数为false时，下一次nextval直接返回4
SELECT setval('public.sequence_user', 4, false);

3. 修正Spring Boot实体类配置 #

在User实体类中配置序列生成策略，确保与数据库序列参数一致：

@Entity
@Table(name = "\"user\"") // 注意user是SQL关键字，需转义
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_sequence_generator")
    @SequenceGenerator(
        name = "user_sequence_generator",
        sequenceName = "sequence_user",
        allocationSize = 5 // 必须与序列的INCREMENT BY值一致
    )
    private Long id;

    // 其他字段及getter/setter
}

4. 验证效果 #

执行完上述操作后，新增用户时框架会自动调用nextval('sequence_user')获取ID，第一个新增用户的ID为4，后续依次为9、14，符合序列配置。

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