42710 duplicate_object

速览

42710 is duplicate_object（重复对象）：定义与已占用的对象名冲突。本页选择第二次 CREATE TYPE ... AS ENUM；同一 SQLSTATE 也会用于其他对象定义，因此必须先确认对象种类和模式。

含义

DefineEnum 路径报告 type "%s" already exists，这是目录定义冲突，不是行级唯一性错误。CREATE OR REPLACE 不是通用修复。检查 pg_type 与 pg_namespace、owner 和迁移顺序。选定自动提交错误后为 IDLE；显式事务必须先回滚。

诊断

先确认对象种类和模式。类型查询 pg_type 与 pg_namespace，关系使用 to_regclass，例程检查 pg_proc 和 pg_get_function_identity_arguments；同时核对 owner 与迁移顺序。

处理

使用确认空闲的名称，或仅在已有对象属于自己且该对象支持时执行特定 ALTER/REPLACE。案例以新 ENUM 名称修复。预检查不能消除并发创建竞争，删除未知对象不安全。显式事务中的定义失败会进入 INERROR，应先回滚或回到合适的 savepoint 再重试；本案例的自动提交路径保持 IDLE。

实测诊断

该 ENUM 分支的固定 ERROR 主报文没有提示；其他 42710 分支可能有不同模板，heap.c 的关系/类型提示不适用于本分支。

代表案例

一次性案例创建 ENUM、重复定义并检查代码与状态，再创建不同名类型并核对两个目录项。

CREATE TYPE syntax_schema.duplicate_object_type AS ENUM ('first');
CREATE TYPE syntax_schema.duplicate_object_type AS ENUM ('first');
CREATE TYPE syntax_schema.duplicate_object_type_repaired AS ENUM ('first');
SELECT count(*) FROM pg_type t JOIN pg_namespace n ON n.oid = t.typnamespace WHERE n.nspname = 'syntax_schema_name' AND t.typname IN ('duplicate_object_type', 'duplicate_object_type_repaired');

选定的 18.6 与 10.21 运行均通过 SQLSTATE、严重级别、状态/恢复、修复、清理和一次性实例停止断言。详见 案例 JSON 与 作者证据；私有清单和注册表哈希也记录在其中。

版本

锁定目录从 7.4 存在边界起包含该条件并列出相关快照。选定自然案例已在 PostgreSQL 18.6 与 10.21 通过；这是有界观察，不能推断所有中间版本或所有源码分支。

相关

• 42723
• 42725
• 42883

来源

• 上游源码 src/backend/commands/typecmds.c 第 1139–1141 行 REL_10_23 02991e79f fa1dfb76
• 上游源码 src/backend/commands/typecmds.c 第 1219–1221 行 REL_18_6 724edf9bd 60d1e975
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 核验材料 verify/cases/42710/cases.json e1a0995c
• 核验材料 verify/cases/42710/snippets.json 4dbc1b9f
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8