42704 — 未定义对象

速览 {#at-a-glance}

SQLSTATE 42704 是 Class 42 中的 undefined_object。42704 表示未定义对象。选定 DROP TRIGGER 路径在真实表上指定不存在的触发器，报告 trigger "%s" for table "%s" does not exist；随后可以创建并删除真实触发器。

含义 {#meaning}

42704 表示未定义对象。get_trigger_oid 按已解析关系 OID 和触发器名称扫描 pg_trigger；当 DROP TRIGGER 要求对象而没有匹配行时，会发出 ERROR：trigger "%s" for table "%s" does not exist。选定路径在真实表上指定不存在的触发器，随后用创建并删除真实触发器验证修复生命周期。

对象类型决定查找方式和报文：固定分支包括类型名解析失败的 type "%s" does not exist、角色查找失败的 role "%s" does not exist、按关系 OID 扫描约束失败的 constraint "%s" for table "%s" does not exist，以及在访问方法下解析限定名或 search_path 中 opclass 失败的 operator class "%s" does not exist for access method "%s"。选定路径更具体：get_trigger_oid 按关系 OID 和触发器名查 pg_trigger，当前表没有匹配行时发出 trigger "%s" for table "%s" does not exist；随后案例只为验证修复生命周期而创建并删除真实触发器。

诊断 {#diagnosis}

先按主报文分类。对于选定触发器分支，检查 DDL 实际解析到的带 schema 关系、准确触发器名称（包括带引号大小写）和迁移顺序；触发器可能存在于另一张表，但由于源码按关系 OID 和名称查找，在当前关系上仍不存在。对于类型或角色报文，检查准确限定名以及 type/role 目录；对于约束报文，检查关系 OID/名称组合和迁移顺序；对于 opclass 报文，检查访问方法以及 opclass 查找使用的 schema/search_path。schema 缺失或未限定关系不存在属于另一类 namespace/未定义关系诊断，权限失败则是 42501。未找到对象的 ERROR 后选定自动提交会话仍为 IDLE；显式 BEGIN 中它会让事务进入 INERROR，直到 ROLLBACK 或回滚到合适保存点。它不同于 dblink 句柄错误 08003 和预备语句名称错误 26000。

处理 {#response}

按报文指出的对象类型修复：改正限定名或 search_path，按依赖顺序应用前置迁移，或在对应 owner 的迁移中创建/重命名预期的 type、role、constraint 或 operator class。仅对选定触发器案例，才应显式操作目标关系，核对 owner、时机/事件、行级或语句级定义及函数，并在迁移要求时删除准确触发器。如果对象本来就是可选的，应有意识地选择幂等迁移策略；不要用 CASCADE、无关对象或通用的“先创建再删除”作为修复。显式事务报错后，先回滚事务或合适保存点，再重试。

报文 {#messages}

选定的 get_trigger_oid 分支以明确的 ERROR 发出主报文 trigger "%s" for table "%s" does not exist；触发器名和表名都是动态值。其他固定未定义对象分支发出 type "%s" does not exist、role "%s" does not exist、constraint "%s" for table "%s" does not exist 或 operator class "%s" does not exist for access method "%s"。只有客户端异常而没有对应对象类型的服务器 SQLSTATE 和主报文时，不能据此识别 42704。

代表案例 {#case}

本页使用与运行器注册表相同的语句。执行时，syntax_schema、syntax_role 等生成名称会替换为一次性实例中的实际值。

CREATE TABLE syntax_schema.trigger_table (id integer);
DROP TRIGGER missing_trigger ON syntax_schema.trigger_table;
CREATE FUNCTION syntax_schema.trigger_function() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN RETURN NEW; END $$;
CREATE TRIGGER valid_trigger BEFORE INSERT ON syntax_schema.trigger_table FOR EACH ROW EXECUTE PROCEDURE syntax_schema.trigger_function();
DROP TRIGGER valid_trigger ON syntax_schema.trigger_table;
SELECT count(*) FROM pg_trigger WHERE tgrelid = 'syntax_schema.trigger_table'::regclass AND NOT tgisinternal;

选定的 18.6 运行记录结构化诊断并通过修复断言；10.21 运行通过同一案例的具体检查。可下载的案例和证据投影分别是 42704 案例 JSON 和 作者证据。运行器清单为 verify/cases/42704/cases.json，页面 SQL 会与共享注册表核对。

版本 {#versions}

选定的自然运行范围是 PostgreSQL 18.6 与 10.21，不能据此推断所有中间版本的行为。

相关 {#related}

• 42703 — 未定义列
• 26000 — 相关条件

来源 {#sources}

• src.errcodes.18.6 — fixed errcodes.txt definition at commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba (source).
• src.missing-trigger.18.6 — src/backend/commands/trigger.c at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 0a539af85b0de1a04779f92202e7bfc77d85ae6da1747ea32527c67f39084fbd (source).
• src.missing-trigger.10.23 — src/backend/commands/trigger.c at REL_10_23 commit 02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4; fixed blob SHA-256 dac7cdcbe2df1a1bbc77daa23e808b0c81ba8891c9895f10e8b270a15316e225 (source).
• src.undefined-type.18.6 / src.undefined-type.10.23 — fixed type-name lookup branches; blob SHA-256 fe4670d2401141761096077c6495dd1b7d6a0baf33c9b903f25baee2f88ffd1e / 729d30e50cea059ccfe13491fdc5f997ff98c227795693bf166a163925beb663 (18.6 source, 10.23 source).
• src.undefined-role.18.6 / src.undefined-role.10.23 — fixed DROP ROLE lookup branches; blob SHA-256 aa8769a2577fff287301d6c82169262cca328515ae940d5a2be4b3e8c21617ed / 9fc68a5a18c4bb5388cc817d2f3f2fcdc64f2752eaa429f78f54b0b443fb59ec (18.6 source, 10.23 source).
• src.undefined-constraint.18.6 / src.undefined-constraint.10.23 — fixed relation-constraint lookup branches; blob SHA-256 0aa324acd355da955f8eb6cec17f1a0138277a8bebd2c6e999cd2a603d3bfa01 / c90dff2d1d863e6b43102d762cec6e08b6c4ba40458045b525a14b49865d8a65 (18.6 source, 10.23 source).
• src.undefined-opclass.18.6 / src.undefined-opclass.10.23 — fixed access-method/opclass lookup branches; blob SHA-256 f28ac0580c805553724dc623dd4e20f32de1a84db637e6ac3c6e3d296bd2fae5 / 85c646706908d13dc449bcffa6690d6ead8d326498051fef6b08f817347fa947 (18.6 source, 10.23 source).
• src.calls.REL_18_6 / src.calls.REL_10_23 — fixed call scans, SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf / 00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c.

来源

• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/commands/trigger.c 第 1383–1386 行 REL_10_23 02991e79f dac7cdcb
• 上游源码 src/backend/commands/trigger.c 第 1406–1409 行 REL_18_6 724edf9bd 0a539af8
• 上游源码 src/backend/catalog/pg_constraint.c 第 781–801 行 REL_10_23 02991e79f c90dff2d
• 上游源码 src/backend/catalog/pg_constraint.c 第 1218–1238 行 REL_18_6 724edf9bd 0aa324ac
• 上游源码 src/backend/commands/opclasscmds.c 第 145–207 行 REL_10_23 02991e79f 85c64670
• 上游源码 src/backend/commands/opclasscmds.c 第 145–207 行 REL_18_6 724edf9bd f28ac058
• 上游源码 src/backend/commands/user.c 第 1017–1023 行 REL_10_23 02991e79f 9fc68a5a
• 上游源码 src/backend/commands/user.c 第 1129–1135 行 REL_18_6 724edf9bd aa8769a2
• 上游源码 src/backend/catalog/objectaddress.c 第 1493–1509 行 REL_10_23 02991e79f 729d30e5
• 上游源码 src/backend/catalog/objectaddress.c 第 1618–1624 行 REL_18_6 724edf9bd fe4670d2
• 核验材料 verify/cases/42704/cases.json ac45b2c3
• 核验材料 verify/cases/42704/snippets.json a75d3b1e
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8