38000

速览

SQLSTATE 38000 是外部例程异常类别。固定的 PostgreSQL 18.6 路径覆盖外部命令、UUID 库和 PL 语言处理器；这些实现必须按各自边界分别诊断。

含义

代表性消息包括 program "%s" failed 和 shell command "%s" failed，二者都带内部 wait-status detail；UUID 路径还会报告 OSSP uuid library failure: %s、OSSP uuid library failure: error code %d、uuid library failure: %d 或 UUID 版本不匹配；PL/Perl 有 didn't get a return item from function 等报文，PL/Python 会转发带可选 detail/context/hint 的 %s，PL/Tcl 则有 could not parse function return value: %s 或带上下文的 %s。应保留动态字段和实际产生者；这个类别没有一条固定消息。

消息

代表性消息包括 program "%s" failed 和 shell command "%s" failed，二者都带内部 wait-status detail；UUID 路径还会报告 OSSP uuid library failure: %s、OSSP uuid library failure: error code %d、uuid library failure: %d 或 UUID 版本不匹配；PL/Perl 有 didn't get a return item from function 等报文，PL/Python 会转发带可选 detail/context/hint 的 %s，PL/Tcl 则有 could not parse function return value: %s 或带上下文的 %s。应保留动态字段和实际产生者；这个类别没有一条固定消息。

诊断

根据消息和 context 确认外部边界：程序路径及等待结果、UUID 库操作，还是 PL 语言和例程。检查相关服务器配置和处理器日志，保留动态 %s 值及内部 detail。

处理

修复消息点名的外部命令、库或语言例程，并独立验证该边界。外部动作失败时可能已经产生副作用；在确认完成状态和幂等性前不要重放。

版本

锁定目录将该条件的已知下界记为 PostgreSQL 7.4；事实块列出已发布快照，源码路径状态仅限于下方固定的 PostgreSQL 18.6 资料。

相关

38001, 2F000

来源

可直接阅读固定的 basebackup_to_shell.c、copyto.c、uuid-ossp.c、plperl.c 和 pltcl.c 路径；完整范围和未解决的运行边界见结构化证据记录。