在 PostgreSQL 中，当手动插入 ID 后需让序列从下一个合理值开始递增时，不能仅靠 ALTER SEQUENCE ... RESTART，而应使用 setval() 显式重置序列值，并确保序列与表列正确关联。
在 postgresql 中，当手动插入 id 后需让序列从下一个合理值开始递增时，不能仅靠 `alter sequence ... restart`，而应使用 `setval()` 显式重置序列值，并确保序列与表列正确关联。
在 Spring Boot 迁移脚本中，你创建了自定义序列 sequence_user 并手动插入了 ID 为 1、2、3 的用户，但后续新增用户却生成了 ID=0 或 ID=1 —— 这是因为序列未被正确“同步”到当前最大 ID 值。ALTER SEQUENCE ... RESTART 默认将序列重置为 START WITH 定义的初始值（如 1），而非基于表中现有数据动态调整，因此无法解决该问题。
✅ 正确做法：用 setval() 同步序列到当前最大 ID
执行以下 SQL 即可将序列值精确设为表中已有最大 ID（此处为 3），使下一次 nextval() 返回 4（符合 INCREMENT BY 5 时则为 8，见后文说明）：
SELECT setval('public.sequence_user', (SELECT COALESCE(MAX(id), 0) FROM public."user"));
⚠️ 注意：COALESCE(MAX(id), 0) 可防止表为空时 MAX(id) 返回 NULL 导致 setval 报错。
? 推荐进阶：将序列绑定到列并设为默认值
为提升可维护性，建议显式建立序列与列的归属关系，并设置列默认值：
-- 将序列归属到 user.id 列（自动管理依赖）
ALTER SEQUENCE public.sequence_user OWNED BY public."user".id;
-- 设置 id 列默认值为该序列的下一个值
ALTER TABLE public."user"
ALTER COLUMN id SET DEFAULT nextval('public.sequence_user');
此时，只要执行一次 setval 同步，后续插入即可完全交由数据库自动处理：
-- 同步序列至当前最大 ID（关键步骤！）
SELECT setval(pg_get_serial_sequence('public.user', 'id'),
(SELECT COALESCE(MAX(id), 0) FROM public."user"));
? 更现代方案：使用 GENERATED ALWAYS AS IDENTITY
PostgreSQL 10+ 推荐使用标准身份列（identity column），它自动创建并管理专属序列，语义更清晰、行为更可靠：
CREATE TABLE public."user" ( id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, first_name VARCHAR(50) NOT NULL, last_name VARCHAR(50) NOT NULL, username VARCHAR(20) NOT NULL, "password" VARCHAR(100) NOT NULL );
此时无需手动指定序列名，pg_get_serial_sequence('public.user', 'id') 会自动返回内部序列名（如 user_id_seq），同步方式一致：
INSERT INTO public."user" (id, first_name, last_name, username, "password")
VALUES (1,'John','Doe','johndoe','...'),
(2,'Frank','James','frank','...'),
(3,'Foo','Bar','foo','...');
-- 同步 identity 序列
SELECT setval(pg_get_serial_sequence('public.user', 'id'),
(SELECT COALESCE(MAX(id), 0) FROM public."user"));
-- 后续插入可省略 id（自动取 nextval），或显式写 DEFAULT
INSERT INTO public."user" (first_name, last_name, username, "password")
VALUES ('Adam', 'Savage', 'adamsavage', '...');
-- → id 自动分配为 4（若 increment=1）或 8（若 increment=5）
? 关键注意事项
- INCREMENT BY 5 意味着序列每次调用 nextval() 都跳 5，因此若当前 setval 设为 3，下一次 nextval() 返回的是 8（不是 4）。如需严格从 4 开始，请先将序列 START WITH 4 并 INCREMENT BY 1，或改用 IDENTITY + INCREMENT BY 1。
- 所有 setval() 调用应在所有手动插入完成后、应用首次使用序列前执行，推荐放在最终迁移脚本末尾。
- 在 Spring Boot 中，确保该 SQL 被包含在 V*.sql 迁移文件中，且执行顺序在 INSERT 之后、应用启动前。
通过以上任一方式（推荐 IDENTITY），即可彻底解决序列起始值错位问题，保障主键连续性与应用稳定性。
