pg_dump默认导出复合主键为UNIQUE+NOT NULL而非PRIMARY KEY，导致约束语义丢失；应显式命名主键、验证dump中PRIMARY KEY多字段定义，并避免误用--disable-triggers或--inserts。
导出时主键丢失：pg_dump 默认不保留复合主键定义
postgresql 的 pg_dump 在默认模式下（如 --format=plain）会生成可执行的 sql，但若表使用 primary key (col_a, col_b) 这类复合主键，且未显式命名约束，dump 输出可能把主键拆成 unique + not null 组合，而非一条完整的 primary key 声明——这会导致重载后约束语义不一致，外键引用失效。
实操建议：
- 始终用
--constraint（实际是--inserts或--column-inserts不影响约束导出，关键在是否加--no-tablespaces和--no-owner？错，真正关键是--no-tablespaces本身无关；正确做法是加--no-tablespaces --no-owner --no-privileges避免权限干扰，但核心是确保不跳过约束）→ 实际应加--no-tablespaces --no-owner --no-privileges并配合--clean，但更直接的是用--schema-only先验证约束是否完整输出 - 强制让复合主键显式命名：建表时写
CONSTRAINT pk_order_items PRIMARY KEY (order_id, item_seq)，否则pg_dump可能生成匿名约束名（如order_items_pkey），在跨版本迁移或重载到新库时容易因命名冲突被跳过 - 导出后手动 grep 验证：
grep -A2 "PRIMARY KEY" dump.sql，确认行中包含括号内多个字段，而非单字段或UNIQUE
外键级联失效：pg_dump --disable-triggers 导致完整性校验绕过
当用 pg_dump --disable-triggers 加速导入时，PostgreSQL 会临时禁用所有触发器（包括由外键产生的 RI 触发器），但该选项**不会禁用约束本身**——问题在于：如果 dump 文件里外键定义缺失或顺序错乱，禁用触发器会让数据插入阶段完全不校验参照完整性，等启用后批量检查失败，报错 ERROR: insert or update on table "orders" violates foreign key constraint "fk_orders_customer_id"。
实操建议：
- 除非明确知道目标库无触发器依赖，否则不要加
--disable-triggers；导出时用默认行为，导入时靠SET CONSTRAINTS ALL DEFERRED控制时机更安全 - 多表有循环外键（如 A→B，B→A）时，
pg_dump默认按依赖顺序输出 DDL，但若用了--inserts，它可能把数据插在约束创建前——此时必须加--column-inserts+--disable-triggers**并配合SET CONSTRAINTS ALL DEFERRED在 SQL 开头手动注入** - 检查 dump 文件中
CREATE TABLE后是否紧跟着ALTER TABLE ... ADD CONSTRAINT ... FOREIGN KEY，而不是全部堆在末尾；若在末尾，说明用了--section=pre-data分离，需确认重载脚本执行顺序
自定义类型/域约束丢失：pg_dump --schema-only 不自动包含 DOMAIN 依赖
如果表字段用到了自定义 DOMAIN（比如 CREATE DOMAIN us_postal_code AS TEXT CHECK (...)），而该 domain 上定义了 CHECK 约束，pg_dump --schema-only 默认只导出 domain 定义，**不导出其上的约束体**，导致重载后字段失去校验逻辑，INSERT INTO t VALUES ('123') 不再报错。
实操建议：
- 加
--include-extensions无效，domain 不算 extension；正确方式是用--dependency模式不行，pg_dump不支持；必须显式加--schema并确保 domain 所在 schema 被包含，同时用--no-owner --no-privileges避免权限语句干扰解析 - 导出后搜索
CREATE DOMAIN，确认其后是否跟有CONSTRAINT子句；若没有，说明 dump 跳过了 constraint，需改用pg_dump -s -n public --no-owner --no-privileges（指定 schema）并人工补全 - 更稳妥的做法：用
pg_dump --schema-only --no-tablespaces --no-owner --no-privileges --if-exists，然后用psql -c "\dD+"对比源库 domain 定义，逐条核对 constraint 表达式是否一致
时间戳与序列值不同步：pg_dump --inserts 忽略 DEFAULT now() 和 nextval()
用 --inserts 导出时，pg_dump 会把每行转成 INSERT INTO t VALUES (1, 'abc', '2024-01-01'); 形式，**完全忽略字段的 DEFAULT 表达式**。这意味着：原表中由 created_at TIMESTAMP DEFAULT now() 自动生成的时间戳，在 dump 中变成固定字面量；序列字段若用 id SERIAL，dump 出的值也是当时快照，重载后 nextval() 从旧值继续，极易主键冲突。
实操建议：
- 要保留默认行为，必须用
--column-inserts（生成带列名的 INSERT）+ 不加--inserts，让 PostgreSQL 在执行时动态计算DEFAULT；但注意：这要求目标库函数可用（如now()、current_timestamp） - 序列值同步的关键是导出
SELECT pg_catalog.setval('seq_name', max_id, true);——pg_dump默认在--inserts模式下不生成此语句；必须加--serializable-deferrable？错，正确参数是--inserts本身不控制序列，需额外加--no-tablespaces --no-owner --no-privileges并确认 dump 文件末尾有SELECT pg_catalog.setval(...)行；若无，手动运行SELECT 'SELECT pg_catalog.setval(''' || s.schemaname || '.' || s.relname || ''', ' || last_value || ', ' || is_called || ');' FROM pg_sequences s JOIN pg_class c ON s.schemaname = c.relnamespace::regnamespace::text AND s.relname = c.relname WHERE c.relkind = 'S'; - 时间敏感场景（如审计表），宁可不用
--inserts，改用--format=custom+pg_restore，它能保留 default 计算逻辑和序列状态
PRIMARY KEY 字样，不代表它在重载时真被当作主键执行；得看它是否在 CREATE TABLE 语句内联定义，是否被后续 ALTER TABLE 覆盖，以及有没有被 --clean 误删。
