百科 / 错误代码 / Class 58 系统错误
58P02 duplicate_file
ERROR 源码确认 参考 未实测
- 条件名
duplicate_file- 宏名称
ERRCODE_DUPLICATE_FILE- 启用版本
- 7.4
- 状态
- 活跃
版本覆盖
速览
58P02 是固定服务器端基础备份输出路径中的 duplicate-file 条件。缺失目录会尝试创建，已有空目录可以使用，已有非空目录则报告此码。
含义
bbsink_server_new() 先检查并提交权限校验事务，然后拒绝相对路径并调用 pg_check_dir(pathname)：结果 0 创建目录，结果 1 接受空目录，结果 2–4 进入固定的 ERRCODE_DUPLICATE_FILE 分支；访问错误走另一条 errcode_for_file_access() 分支。这是基础备份输出保护，不证明 PostgreSQL 中所有 EEXIST 或非空目录都使用 58P02。
消息
- ERROR，SQLSTATE
58P02：directory "%s" exists but is not empty。 - ERROR，使用
errcode_for_file_access()：could not access directory "%s": %m。 - ERROR，目标不存在但创建失败时，使用
errcode_for_file_access()：could not create directory "%s": %m。
后两个模板的 SQLSTATE 由保存的 OS errno 决定，不能因为它们在同一函数中就都标成 58P02。
报文模板
源码里的格式串，不是某一次运行的输出。%s 之类是占位符，实际报文会填入对象名与取值。适用范围一栏是核验时留下的原始英文记录，未经翻译。
directory "%s" exists but is not empty
could not access directory "%s": %m
could not create directory "%s": %m
诊断
确认路径确实是预期的基础备份目标，检查所有者、挂载和内容，并判断是完整旧备份还是中断产物；变更前保留目录清单。源码在内部权限校验事务提交后才准备输出目录，因此这里表示备份建立失败，不能假设可以靠继续执行 SQL 修复用户 DML 事务。
处理
按备份策略使用已确认为空的目标，或先归档旧输出。创建后验证完整备份和 manifest；不要递归删除或强制覆盖未知目录。若外层客户端报告 ERROR，按实际会话状态回滚到已有保存点或事务；ROLLBACK 不能把非空备份目录变安全。只有所属服务器进程被终止时才需要新连接。
版本
锁定目录从 7.4 记录此条件；固定基础备份路径来自 PostgreSQL 18.6。本源码条目没有修改或测试备份目标。
来源
- 上游源码 src/backend/utils/errcodes.txt 第 447 行
- 上游源码 src/backend/backup/basebackup_server.c 第 59 行
证据
断言
每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。
-
58P02 is duplicate_file in SQLSTATE Class 58.
-
The server-side base-backup sink commits its privilege-check transaction before checking the output directory, accepts empty targets, and emits 58P02 only for an existing non-empty target; other branches use errno-selected codes.
-
The locked catalogue records 58P02 from 7.4; it does not prove every historical duplicate-file caller.
同类错误代码
Class 58 系统错误 下的其他成员。