PostgreSQL 表继承常见问题与解决方法
很多新手在用 PostgreSQL 表继承(INHERITS)时,会踩一堆意料之外的坑。表继承功能灵活,但它有不少天生限制,很多问题不是bug,是设计特性。本文整理开发中最高频的问题、现象、原因以及可行方案,方便你排查和规避风险。
前置提醒:表继承 ≠ 声明式分区。如果你的目标只是拆分大表、按时间分区,优先使用
PARTITION BY,从根源避开下面绝大多数问题。
问题1:父表建了主键/唯一约束,父子之间依然出现重复ID
现象
父表定义 id 为主键,往父表插入 id=1,再往子表手动插入 id=1,数据库不会报错,查询父表时能看到两条id相同的数据。
原因
主键、唯一约束、唯一索引只在单张物理表内生效,不会跨继承树全局校验。父表的唯一索引只管父表自己,看不到子表;子表的唯一索引只管子表内部。
解决办法
- 方案1(简单):全局共用同一个序列,自动生成ID。自动生成的ID天然不会重复;但依然挡不住人为手动指定重复ID,适合规范严格、禁止手动写id的项目。
CREATE SEQUENCE global_id_seq;
CREATE TABLE parent(id bigint DEFAULT nextval('global_id_seq'), name text);
CREATE TABLE child() INHERITS(parent);
- 方案2(数据库层面校验):写行级触发器,插入前去扫描整个继承树,判断id是否已经存在。缺点:数据量大时,校验性能差。
- 方案3(推荐):业务层保证全局唯一,在应用代码里生成雪花ID、UUID,数据库不负责全局唯一性校验。
- 方案4:放弃表继承,改用声明式分区。
避坑:不要误以为
PRIMARY KEY会自动覆盖所有子表,这是新手最容易踩的大坑。
问题2:自增ID冲突,子表ID从1开始互相撞号
现象
父表不定义自增,每个子表单独设置 serial / identity。child1 插入id=1,child2 也插入id=1,查询父表出现重复主键。
原因
每个子表的序列是独立对象,互不感知。
解决办法
- 统一使用同一个全局序列,所有子表和父表共用;
- 序列分段:child1 使用1
1000000,child2 使用10000012000000,单独设置序列起始值; - 业务侧使用UUID、雪花ID,彻底规避序列冲突。
问题3:外键失效,无法引用子表的数据
现象
其他表 REFERENCES parent(id),只能引用父表里面的数据,引用不到子表的数据;反过来,子表数据也无法被外键正常关联校验。
原因
外键约束同样只作用于单张物理表,继承树不参与外键的参照完整性校验。官方文档明确标注这是继承的硬限制。
解决办法
- 尽量不要对继承树做外键关联;
- 业务代码自己做关联校验;
- 模型重构:改用声明分区或者普通关联表,把外键约束交给数据库原生支持。
结论:表继承不适合强依赖外键的业务模型。
问题4:查询父表的时候,不小心把子表数据查出来;或者只想查父表,结果数据不对
现象
SELECT * FROM parent; 自动带出所有子表数据,统计、报表、分页逻辑出错。
原因
PG默认规则:查询父表,自动递归所有子表。
解决办法
- 只想查父表本身:加上
ONLY
SELECT * FROM ONLY parent;
- 查看这条数据来自哪张子表:
tableoid::regclass
SELECT tableoid::regclass, * FROM parent;
UPDATE / DELETE同样支持ONLY,控制是否修改子表。
问题5:插入父表,数据不会自动落到子表(不能自动路由)
现象
INSERT INTO parent VALUES(...),数据直接存在父表,不会自动跑到符合条件的子表里,和分区表表现不一样。
原因
传统表继承没有原生写入路由逻辑,写入哪张表,数据就落在哪张物理表。声明式分区才自带自动路由。
解决办法
- 写
BEFORE INSERT触发器,判断条件,把数据转发到对应子表,然后返回NULL; - 或者用 RULE 规则(RULE 有很多边界bug,不推荐生产);
- 简单分区场景直接换成声明式分区,原生支持路由,不用自己写触发器。
问题6:索引管理麻烦,REINDEX、VACUUM 不会递归子表
现象
给父表建索引,索引不会自动创建到子表;执行 REINDEX TABLE parent,只会重建父表索引,子表索引不动;慢查询排查时,发现子表没有索引,查询全表扫描。
原因
索引是绑定在单张物理表上的对象,不属于继承同步内容;运维命令默认不会递归继承树。
解决办法
- 创建子表的时候,手动给每个子表单独建立索引;
- 写运维脚本,遍历继承树,批量 vacuum、reindex;
- 新增子表时,作为标准化流程,自动同步索引、check约束;
- 监控所有子表的索引使用情况,避免漏建。
问题7:权限问题:查父表报错,子表没授权
现象
用户已经拥有父表的select权限,但是查询父表时报权限不足。
原因
查询父表连带读取子表时,需要同时拥有所有子表的对应权限,父表权限不能自动覆盖子表。新增子表之后,权限不会自动继承授予。
解决办法
- 新增子表后,统一执行授权语句;
- 封装建子表的脚本,建表时自动给业务账号授权;
- 如果只需要访问父表本身,使用
ONLY语法,不需要子表权限。
问题8:ALTER修改父表字段,子表字段跟着变,意外影响业务
现象
给父表新增字段、修改字段类型,所有子表自动同步修改;删除父表字段忘记加 CASCADE,直接报错。
原因
NOT NULL、列定义、CHECK约束会向下传播到全部子表。
解决办法
- 修改父表结构前,先梳理全部子表,评估影响;
- 删除父表字段必须加
CASCADE:
ALTER TABLE parent DROP COLUMN col1 CASCADE;
- 如果某些约束不想传给子表,建约束时加
NO INHERIT:
ALTER TABLE parent ADD CONSTRAINT ck CHECK (val>0) NO INHERIT;
问题9:ORM框架(MyBatis、EF Core、Django ORM)识别异常、报错
现象
ORM自动生成SQL、迁移脚本时,不理解表继承,会重复建表、主键冲突、查询逻辑错乱。
原因
绝大多数ORM是面向单表设计,没有对PG表继承的专门适配。
解决办法
- 尽量不要让ORM管理继承表结构,DDL脚本手动维护;
- 业务查询尽量写原生SQL,慎用ORM自动查询;
- 模型复杂时,放弃表继承,改用普通外键或者声明分区。
问题10:多重继承,同名字段类型冲突报错
现象
子表同时继承多张父表,父表有相同名字的字段,类型不一致,创建子表失败。
原因
多重继承会合并所有父表字段,同名字段必须数据类型完全一致。
解决办法
- 提前统一父表同名字段的数据类型;
- 模型设计上,尽量控制多重继承的数量,多重继承模型可读性差,维护成本高。
综合避坑清单(生产环境使用表继承必看)
✅ 适合用表继承:
- 需要多重继承;
- 子类需要额外独有字段;
- 分类模型,不需要强数据库层面唯一性、外键。
❌ 尽量不要用:
- 需要跨父子全局主键、唯一约束;
- 依赖外键做参照完整性;
- 单纯用来做日志、流水、时间分区;
- 项目重度依赖ORM自动迁移。
终极替代方案
如果你的需求是数据分区:优先选择声明式分区(PARTITION BY),原生支持自动路由、分区索引,维护简单,是官方推荐方案。
如果你的需求是多态分类、子类扩展字段,并且能接受在业务层做唯一性、关联校验,才考虑表继承。