42P04 — 重复数据库

速览 {#at-a-glance}

42P04（duplicate_database）表示数据库管理路径发现集群中已有同名数据库。这是集群级名称检查，不是当前库内的关系冲突；CREATE 和 RENAME 的外围检查也不同。

含义 {#meaning}

createdb 会用 get_database_oid(dbname, true) 检查目标名称，冲突时报告 ERROR database "%s" already exists。RenameDatabase 在查找旧数据库、检查所有权和 CREATEDB 权限之后，对 newname 做同样检查。因此 %s 在 CREATE 中是请求的数据库名，在 RENAME 中是新名称。

utility 分发器在进入 createdb 前调用 PreventInTransactionBlock(isTopLevel, "CREATE DATABASE")。所以在显式事务中执行 CREATE DATABASE 是另一种事务块错误，不能据此声称发出了 42P04；RENAME 则有独立的旧名、所有权、权限和新名检查。

诊断 {#diagnosis}

确认目标集群和准确名称，检查 pg_database、标识符折叠和迁移竞争。CREATE 另查目标名称、模板和所有者前提；RENAME 同时查旧名、新名、所有权和 CREATEDB。旧数据库不存在或权限不足不应误判为 42P04。

处理 {#response}

已有库就是目标时让编排幂等并检查它；否则选择未占用名称。CREATE DATABASE 要在顶层、显式事务块之外执行。RENAME 只有在确认旧库、所有权、CREATEDB、活动会话、依赖和集群身份后才选择可用新名。如果 RENAME 在显式事务中报错，下一条命令前应执行 ROLLBACK；若必须保留外层事务，则回滚到改名前建立的保存点。删除或改名不是所有 42P04 的通用修复。

消息变体 {#messages}

选定路径均为 ERROR database "%s" already exists：createdb 使用请求名称，RenameDatabase 使用新名称。utility 中的 PreventInTransactionBlock 证明 CREATE DATABASE 有独立事务限制，不是另一条 42P04 报文。

版本 {#versions}

目录范围从 7.4 到 18.6、19beta3，不是精确的功能引入判断。选定的是 18.6 固定 CREATE、RENAME 和分发器事务检查路径，未运行数据库。

相关 {#related}

• 42P07
• 42P06
• 42710

来源 {#sources}

• src.errcodes.42P04.18.6 — src/backend/utils/errcodes.txt line 379，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba（源码）。

• src.call.42P04.465a77b5605c341bc91f6990 — src/backend/commands/dbcommands.c lines 1393-1395，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 64b77d2197dce16eb1ad19d8168382459d621a03df0b00be157f7db39ca22acf（源码）。

• src.call.42P04.b0d1644def83c14a7504fec4 — src/backend/commands/dbcommands.c lines 1949-1951，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 64b77d2197dce16eb1ad19d8168382459d621a03df0b00be157f7db39ca22acf（源码）。

• src.call.42P04.create-tx-guard — src/backend/tcop/utility.c lines 769-773，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 7aae5d07628b6debf8456d1d4ea96f28912232192e56ea25773b4c4b61235a00（源码）。

• src.calls.REL_18_6.42P04 — 固定本地核心调用扫描；SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf。

• 作者证据 — 记录源码断言、消息角色和运行边界。

来源

• 上游源码 src/backend/commands/dbcommands.c 第 1393–1395 行 REL_18_6 724edf9bd 64b77d21
• 上游源码 src/backend/commands/dbcommands.c 第 1949–1951 行 REL_18_6 724edf9bd 64b77d21
• 上游源码 src/backend/tcop/utility.c 第 769–773 行 REL_18_6 724edf9bd 7aae5d07
• 上游源码 src/backend/utils/errcodes.txt 第 379 行 REL_18_6 724edf9bd 6e8de346
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8