# 42710 — 重复对象（duplicate_object）

> PostgreSQL SQLSTATE 42710（重复对象，duplicate_object）的源码证据、诊断与处理参考。
---

# 42710 — 重复对象（duplicate_object）

## 速览 {#at-a-glance}

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

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `42710` |
| 条件名 | `duplicate_object` |
| 状态 | `有效` |
| 已知存在于 | `7.4` |
| 锁定快照 | `9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_DUPLICATE_OBJECT` |
| 别名 | `—` |

<!-- source facts: data/errcodes/42710.json -->
<!-- END SQLSTATE FACTS -->

## 含义 {#meaning}

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

## 诊断 {#diagnosis}

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

## 处理 {#response}

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

## 实测诊断 {#messages}

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

## 代表案例 {#case}

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

<!-- BEGIN SQLSTATE SNIPPET: duplicate_object_type -->

```sql
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');
```

<!-- END SQLSTATE SNIPPET -->

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

## 版本 {#versions}

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

## 相关 {#related}

- [`42723`](../42723/)
- [`42725`](../42725/)
- [`42883`](../42883/)

## 来源 {#sources}

- `src.errcodes.REL_18_6` — fixed definition at `724edf9bde9d356724ad384a2e196edc3c9f80f7`; SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt#L1-L1)).
- `src.duplicate-enum.18.6` — `src/backend/commands/typecmds.c` lines 1219–1221 at `724edf9bde9d356724ad384a2e196edc3c9f80f7`; blob SHA-256 `60d1e9754646e100f6b74aa367ad8c2c52386c400df721707423d329209c47eb` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/commands/typecmds.c#L1219-L1221)).
- `src.duplicate-enum.10.23` — `src/backend/commands/typecmds.c` lines 1139–1141 at `02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4`; blob SHA-256 `fa1dfb766f7a3117eb677461ede774d5ba7c25324cbbd2a200435fa9c9c8e863` ([source](https://github.com/postgres/postgres/blob/02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4/src/backend/commands/typecmds.c#L1139-L1141)).
- `src.calls.REL_18_6` / `src.calls.REL_10_23` — fixed call scans, SHA-256 `9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf` / `00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c`.
- `manifest.42710` / `snippet-registry.42710` — hashes are recorded in `evidence/42710.json` and each runtime record.