PostgreSQL SQLSTATE 大典

• 1: 全部 SQLSTATE 错误码
• 2: SQLSTATE 错误类
• 3: 常见错误码
• 4: 主题
• 5: PostgreSQL 版本
• 6: 指南
• 7: 覆盖范围
• 8: 方法
• 9: 00000 — successful_completion
• 10: 01000 — warning（警告）
• 11: 01003 — null_value_eliminated_in_set_function
• 12: 01004 — string_data_right_truncation
• 13: 01006 — privilege_not_revoked
• 14: 01007 — privilege_not_granted
• 15: 01008 — implicit_zero_bit_padding
• 16: 0100C — dynamic_result_sets_returned
• 17: 01P01 — deprecated_feature
• 18: 02000 — no_data
• 19: 02001 — no_additional_dynamic_result_sets_returned
• 20: 03000 — sql_statement_not_yet_complete
• 21: 08000 — 连接异常（connection_exception）
• 22: 08001 — 无法建立 SQL 连接（sqlclient_unable_to_establish_sqlconnection）
• 23: 08003 — 连接不存在（connection_does_not_exist）
• 24: 08004 — 服务器拒绝建立 SQL 连接（sqlserver_rejected_establishment_of_sqlconnection）
• 25: 08006 — 连接失败（connection_failure）
• 26: 08007 — 事务结果未知（transaction_resolution_unknown）
• 27: 08P01 — 协议违规（protocol_violation）
• 28: 09000 — triggered_action_exception
• 29: 0A000 — 不支持的功能（feature_not_supported）
• 30: 0B000 — invalid_transaction_initiation
• 31: 0F000 — locator_exception
• 32: 0F001 — invalid_locator_specification
• 33: 0L000 — 授权者无效（invalid_grantor）
• 34: 0LP01 — 无效的授权操作（invalid_grant_operation）
• 35: 0P000 — 角色规范无效（invalid_role_specification）
• 36: 0Z000 — diagnostics_exception
• 37: 0Z002 — stacked_diagnostics_accessed_without_active_handler
• 38: 10608 — invalid_argument_for_xquery
• 39: 20000 — case_not_found
• 40: 21000 — 基数冲突（cardinality_violation）
• 41: 22000 — data_exception
• 42: 22001 — string_data_right_truncation
• 43: 22002 — null_value_no_indicator_parameter
• 44: 22003 — numeric_value_out_of_range
• 45: 22004 — null_value_not_allowed
• 46: 22005 — error_in_assignment
• 47: 22007 — invalid_datetime_format
• 48: 22008 — datetime_field_overflow
• 49: 22009 — invalid_time_zone_displacement_value
• 50: 2200B — escape_character_conflict
• 51: 2200C — invalid_use_of_escape_character
• 52: 2200D — invalid_escape_octet
• 53: 2200F — zero_length_character_string
• 54: 2200G — most_specific_type_mismatch
• 55: 2200H — sequence_generator_limit_exceeded
• 56: 2200L — not_an_xml_document
• 57: 2200M — invalid_xml_document
• 58: 2200N — invalid_xml_content
• 59: 2200S — invalid_xml_comment
• 60: 2200T — invalid_xml_processing_instruction
• 61: 22010 — invalid_indicator_parameter_value
• 62: 22011 — substring_error
• 63: 22012 — division_by_zero
• 64: 22013 — invalid_preceding_or_following_size
• 65: 22014 — invalid_argument_for_ntile_function
• 66: 22015 — interval_field_overflow
• 67: 22016 — invalid_argument_for_nth_value_function
• 68: 22018 — invalid_character_value_for_cast
• 69: 22019 — invalid_escape_character
• 70: 2201B — invalid_regular_expression
• 71: 2201E — invalid_argument_for_logarithm
• 72: 2201F — invalid_argument_for_power_function
• 73: 2201G — invalid_argument_for_width_bucket_function
• 74: 2201W — invalid_row_count_in_limit_clause
• 75: 2201X — invalid_row_count_in_result_offset_clause
• 76: 22021 — character_not_in_repertoire
• 77: 22022 — indicator_overflow
• 78: 22023 — invalid_parameter_value
• 79: 22024 — unterminated_c_string
• 80: 22025 — invalid_escape_sequence
• 81: 22026 — string_data_length_mismatch
• 82: 22027 — trim_error
• 83: 2202E — array_subscript_error（数组下标错误）
• 84: 2202G — invalid_tablesample_repeat
• 85: 2202H — invalid_tablesample_argument
• 86: 22030 — duplicate_json_object_key_value
• 87: 22031 — invalid_argument_for_sql_json_datetime_function
• 88: 22032 — invalid_json_text
• 89: 22033 — invalid_sql_json_subscript
• 90: 22034 — more_than_one_sql_json_item
• 91: 22035 — no_sql_json_item
• 92: 22036 — non_numeric_sql_json_item
• 93: 22037 — non_unique_keys_in_a_json_object
• 94: 22038 — singleton_sql_json_item_required
• 95: 22039 — sql_json_array_not_found
• 96: 2203A — sql_json_member_not_found
• 97: 2203B — sql_json_number_not_found
• 98: 2203C — sql_json_object_not_found
• 99: 2203D — too_many_json_array_elements
• 100: 2203E — too_many_json_object_members
• 101: 2203F — sql_json_scalar_required
• 102: 2203G — sql_json_item_cannot_be_cast_to_target_type
• 103: 22P01 — floating_point_exception
• 104: 22P02 — 文本表示无效
• 105: 22P03 — invalid_binary_representation
• 106: 22P04 — bad_copy_file_format
• 107: 22P05 — untranslatable_character
• 108: 22P06 — nonstandard_use_of_escape_character
• 109: 23000 — 完整性约束冲突（integrity_constraint_violation）
• 110: 23001 — RESTRICT 约束冲突（restrict_violation）
• 111: 23502 — 非空约束冲突（not_null_violation）
• 112: 23503 — foreign_key_violation：外键约束冲突
• 113: 23505 — unique_violation：唯一性冲突
• 114: 23514 — CHECK 约束冲突（check_violation）
• 115: 23P01 — 排除约束冲突（exclusion_violation）
• 116: 24000 — 游标状态无效（invalid_cursor_state）
• 117: 25000 — 事务状态无效（invalid_transaction_state）
• 118: 25001 — 活动 SQL 事务（active_sql_transaction）
• 119: 25002 — 分支事务已活动（branch_transaction_already_active）
• 120: 25003 — 分支事务访问模式不适用（inappropriate_access_mode_for_branch_transaction）
• 121: 25004 — 分支事务隔离级别不适用（inappropriate_isolation_level_for_branch_transaction）
• 122: 25005 — 分支事务没有活动 SQL 事务（no_active_sql_transaction_for_branch_transaction）
• 123: 25006 — 只读 SQL 事务（read_only_sql_transaction）
• 124: 25007 — 不支持混合模式与数据语句（schema_and_data_statement_mixing_not_supported）
• 125: 25008 — 持有游标要求相同隔离级别（held_cursor_requires_same_isolation_level）
• 126: 25P01 — 没有活动 SQL 事务（no_active_sql_transaction）
• 127: 25P02 — 事务处于失败状态（in_failed_sql_transaction）
• 128: 25P03 — 事务中空闲会话超时（idle_in_transaction_session_timeout）
• 129: 25P04 — 事务超时（transaction_timeout）
• 130: 26000 — invalid_sql_statement_name（预备语句名称无效）
• 131: 27000 — triggered_data_change_violation（触发的数据更改违规）
• 132: 28000 — 授权规范无效（invalid_authorization_specification）
• 133: 28P01 — invalid_password（密码无效）
• 134: 2B000 — dependent_privilege_descriptors_still_exist（依赖权限描述符仍存在）
• 135: 2BP01 — dependent_objects_still_exist（依赖对象仍存在）
• 136: 2D000 — invalid_transaction_termination（无效事务终止）
• 137: 2F000 — sql_routine_exception
• 138: 2F002 — modifying_sql_data_not_permitted
• 139: 2F003 — prohibited_sql_statement_attempted
• 140: 2F004 — reading_sql_data_not_permitted
• 141: 2F005 — function_executed_no_return_statement
• 142: 34000 — invalid_cursor_name（游标名称无效）
• 143: 38000 — external_routine_exception
• 144: 38001 — containing_sql_not_permitted
• 145: 38002 — modifying_sql_data_not_permitted
• 146: 38003 — prohibited_sql_statement_attempted
• 147: 38004 — reading_sql_data_not_permitted
• 148: 39000 — external_routine_invocation_exception
• 149: 39001 — invalid_sqlstate_returned
• 150: 39004 — null_value_not_allowed
• 151: 39P01 — trigger_protocol_violated
• 152: 39P02 — srf_protocol_violated
• 153: 39P03 — event_trigger_protocol_violated
• 154: 3B000 — savepoint_exception（保存点异常）
• 155: 3B001 — invalid_savepoint_specification（保存点说明无效）
• 156: 3D000 — 目录名称无效（invalid_catalog_name）
• 157: 3F000 — 模式名称无效（invalid_schema_name）
• 158: 40000 — transaction_rollback（事务回滚）
• 159: 40001 — serialization_failure：序列化失败
• 160: 40002 — transaction_integrity_constraint_violation（事务完整性约束违规）
• 161: 40003 — statement_completion_unknown（语句完成状态未知）
• 162: 40P01 — deadlock_detected：检测到死锁
• 163: 42000 — 语法错误或访问规则违反（syntax_error_or_access_rule_violation）
• 164: 42501 — 权限不足（insufficient_privilege）
• 165: 42601 — 语法错误（syntax_error）
• 166: 42602 — 名称无效（invalid_name）
• 167: 42611 — 列定义无效（invalid_column_definition）
• 168: 42622 — 名称过长（name_too_long）
• 169: 42701 — 重复列（duplicate_column）
• 170: 42702 — 列引用歧义（ambiguous_column）
• 171: 42703 — 未定义列（undefined_column）
• 172: 42704 — 未定义对象（undefined_object）
• 173: 42710 — 重复对象（duplicate_object）
• 174: 42712 — 重复别名（duplicate_alias）
• 175: 42723 — 重复函数（duplicate_function）
• 176: 42725 — 函数调用歧义（ambiguous_function）
• 177: 42803 — 分组错误（grouping_error）
• 178: 42804 — 数据类型不匹配（datatype_mismatch）
• 179: 42809 — 对象类型错误（wrong_object_type）
• 180: 42830 — 无效外键（invalid_foreign_key）
• 181: 42846 — 无法强制转换（cannot_coerce）
• 182: 42883 — 未定义函数（undefined_function）
• 183: 428C9 — GENERATED ALWAYS 列赋值
• 184: 42939 — 保留名称
• 185: 42P01 — undefined_table：未定义的表或关系
• 186: 42P02 — 未定义参数
• 187: 42P03 — 重复游标
• 188: 42P04 — 重复数据库
• 189: 42P05 — 重复预备语句
• 190: 42P06 — 重复模式
• 191: 42P07 — 重复表或关系定义
• 192: 42P08 — 参数类型不明确
• 193: 42P09 — 表别名不明确
• 194: 42P10 — 无效列引用
• 195: 42P11 — 无效游标定义
• 196: 42P12 — 无效数据库定义
• 197: 42P13 — 无效函数定义
• 198: 42P14 — 无效预备语句定义
• 199: 42P15 — 无效模式定义
• 200: 42P16 — 无效表定义
• 201: 42P17 — 无效对象定义
• 202: 42P18 — 无法确定数据类型
• 203: 42P19 — 无效递归
• 204: 42P20 — 窗口函数错误
• 205: 42P21 — 排序规则不匹配
• 206: 42P22 — 无法确定排序规则
• 207: 44000 — with_check_option_violation（WITH CHECK OPTION 违规）
• 208: 53000 — insufficient_resources
• 209: 53100 — disk_full
• 210: 53200 — out_of_memory
• 211: 53300 — too_many_connections（连接数过多）
• 212: 53400 — configuration_limit_exceeded
• 213: 54000 — program_limit_exceeded
• 214: 54001 — statement_too_complex
• 215: 54011 — too_many_columns
• 216: 54023 — too_many_arguments
• 217: 55000 — 对象未处于前置状态
• 218: 55006 — 对象正在使用
• 219: 55P02 — cant_change_runtime_param
• 220: 55P03 — lock_not_available
• 221: 55P04 — unsafe_new_enum_value_usage
• 222: 57000 — operator_intervention
• 223: 57014 — query_canceled：查询已取消
• 224: 57P01 — admin_shutdown
• 225: 57P02 — crash_shutdown
• 226: 57P03 — cannot_connect_now
• 227: 57P04 — database_dropped
• 228: 57P05 — idle_session_timeout
• 229: 58000 — system_error
• 230: 58030 — io_error
• 231: 58P01 — undefined_file
• 232: 58P02 — duplicate_file
• 233: 58P03 — file_name_too_long
• 234: 72000 — snapshot_too_old
• 235: F0000 — config_file_error
• 236: F0001 — lock_file_exists
• 237: HV000 — fdw_error（外部数据包装器错误）
• 238: HV001 — fdw_out_of_memory（外部数据包装器内存不足）
• 239: HV002 — fdw_dynamic_parameter_value_needed（需要外部数据包装器动态参数）
• 240: HV004 — fdw_invalid_data_type（外部数据包装器数据类型无效）
• 241: HV005 — fdw_column_name_not_found（找不到外部列名）
• 242: HV006 — fdw_invalid_data_type_descriptors（外部数据类型描述符无效）
• 243: HV007 — fdw_invalid_column_name（外部列名无效）
• 244: HV008 — fdw_invalid_column_number（外部列号无效）
• 245: HV009 — fdw_invalid_use_of_null_pointer（外部数据包装器非法使用空指针）
• 246: HV00A — fdw_invalid_string_format（外部数据包装器字符串格式无效）
• 247: HV00B — fdw_invalid_handle
• 248: HV00C — fdw_invalid_option_index
• 249: HV00D — fdw_invalid_option_name
• 250: HV00J — fdw_option_name_not_found
• 251: HV00K — fdw_reply_handle
• 252: HV00L — fdw_unable_to_create_execution
• 253: HV00M — fdw_unable_to_create_reply
• 254: HV00N — fdw_unable_to_establish_connection
• 255: HV00P — fdw_no_schemas
• 256: HV00Q — fdw_schema_not_found
• 257: HV00R — fdw_table_not_found
• 258: HV010 — fdw_function_sequence_error
• 259: HV014 — fdw_too_many_handles
• 260: HV021 — fdw_inconsistent_descriptor_information
• 261: HV024 — fdw_invalid_attribute_value
• 262: HV090 — fdw_invalid_string_length_or_buffer_length
• 263: HV091 — fdw_invalid_descriptor_field_identifier
• 264: P0000 — plpgsql_error
• 265: P0001 — raise_exception（引发异常）
• 266: P0002 — no_data_found
• 267: P0003 — too_many_rows
• 268: P0004 — assert_failure
• 269: PostgreSQL 10.23 — 正式版本
• 270: PostgreSQL 11.22 — 正式版本
• 271: PostgreSQL 12.22 — 正式版本
• 272: PostgreSQL 13.23 — 正式版本
• 273: PostgreSQL 14.24 — 正式版本
• 274: PostgreSQL 15.19 — 正式版本
• 275: PostgreSQL 16.15 — 正式版本
• 276: PostgreSQL 17.11 — 正式版本
• 277: PostgreSQL 18.6 — 正式版本
• 278: PostgreSQL 19beta3 — 预发行
• 279: PostgreSQL 9.0.23 — 正式版本
• 280: PostgreSQL 9.1.24 — 正式版本
• 281: PostgreSQL 9.2.24 — 正式版本
• 282: PostgreSQL 9.3.25 — 正式版本
• 283: PostgreSQL 9.4.26 — 正式版本
• 284: PostgreSQL 9.5.25 — 正式版本
• 285: PostgreSQL 9.6.24 — 正式版本
• 286: XX000 — internal_error（内部错误）
• 287: XX001 — data_corrupted
• 288: XX002 — index_corrupted
• 289: 类别 00 — 成功完成
• 290: 类别 01 — 警告
• 291: 类别 02 — 无数据
• 292: 类别 03 — SQL语句尚未完成
• 293: 类别 08 — 连接异常
• 294: 类别 09 — 触发动作异常
• 295: 类别 0A — 不支持的特性
• 296: 类别 0B — 无效的事务发起
• 297: 类别 0F — 定位器异常
• 298: 类别 0L — 无效授权者
• 299: 类别 0P — 无效角色规范
• 300: 类别 0Z — 诊断异常
• 301: 类别 10 — XQuery错误
• 302: 类别 20 — 未找到 Case
• 303: 类别 21 — 基数冲突
• 304: 类别 22 — 数据异常
• 305: 类别 23 — 完整性约束冲突
• 306: 类别 24 — 游标状态无效
• 307: 类别 25 — 事务状态无效
• 308: 类别 26 — SQL语句名称无效
• 309: 类别 27 — 触发数据变更冲突
• 310: 类别 28 — 授权规范无效
• 311: 类别 2B — 依赖权限描述符仍存在
• 312: 类别 2D — 事务终止无效
• 313: 类别 2F — SQL例程异常
• 314: 类别 34 — 游标名称无效
• 315: 类别 38 — 外部例程异常
• 316: 类别 39 — 外部例程调用异常
• 317: 类别 3B — 保存点异常
• 318: 类别 3D — 目录名称无效
• 319: 类别 3F — 模式名称无效
• 320: 类别 40 — 事务回滚
• 321: 类别 42 — 语法错误或访问规则冲突
• 322: 类别 44 — WITH CHECK OPTION 冲突
• 323: 类别 53 — 资源不足
• 324: 类别 54 — 程序限制超出
• 325: 类别 55 — 前置状态不满足
• 326: 类别 57 — 操作员干预
• 327: 类别 58 — 系统错误
• 328: 类别 72 — 快照失败
• 329: 类别 F0 — 配置文件错误
• 330: 类别 HV — 外部数据包装器错误
• 331: 类别 P0 — PL/pgSQL错误
• 332: 类别 XX — 内部错误

1 - 全部 SQLSTATE 错误码

按类别、版本和内容深度筛选全部 SQLSTATE。每个错误码都链接到已审阅的中英文说明；当前内容与运行核验范围见覆盖报告。

身份和证据约定请看方法页面。

2 - SQLSTATE 错误类

错误类按 SQLSTATE 的前两位分组。class 只表示大致的条件家族，不能据此断定所有成员具有相同的严重性、事务后果或重试行为。

生成的成员列表链接到每个错误码唯一的规范页面。class 只是目录身份，具体机制和恢复方式仍看错误码页面。

3 - 常见错误码

这里按常见排查路径提供编辑精选入口，不代表生产环境频率排名；每一行说明该条目帮助回答的具体问题，并保留其审阅状态。

4 - 主题

主题包括约束冲突、认证与授权、事务重试、锁与超时、对象解析以及资源或系统故障。主题只指向错误码页面，不为同一个条件建立第二个身份。

5 - PostgreSQL 版本

生成的表格会把正式 PostgreSQL 发布版与最新预发行快照分开。存在表示冻结源码中找到了该定义；这本身不等于证明运行时路径或精确的引入版本。

6 - 指南

先读协议诊断

先确认协议消息类型。PostgreSQL 用 ErrorResponse 表示错误，用 NoticeResponse 表示通知；两者都携带以零字节结束的带标识字段。C 是不可本地化的 SQLSTATE，M 是主消息，D/H 分别是可选 detail 与 hint。S 可能本地化，V 是服务器提供时的未本地化 severity。schema（s）、table（t）、column（c）、constraint（n）、position（P）、context（W）、源码文件（F）、行号（L）和 routine（R）等字段都是有条件的；有就保留，没有就不要推断。参见 PostgreSQL 18 错误与通知字段 和消息格式。

目录类别只是分类。决定语句是否失败前，要先读取实际协议严重性和消息类型。WARNING 或 NOTICE 可以作为通知送达，同时命令仍然完成；ERROR 作为错误送达，通常会改变显式事务状态。成功的 CommandComplete 只有命令标签，不携带 ErrorResponse SQLSTATE。把服务器版本和操作一起保留，因为相同 SQLSTATE 可能对应不同源码路径。

恢复正确的事务边界

自动提交为每条语句建立独立事务边界。语句错误后，连接通常仍可执行下一条语句。显式事务中的未处理 ERROR 会使事务进入失败状态；之后普通命令会被 PostgreSQL 以 25P02 拒绝，直到回滚。25P02 是后续观察，不是第一条错误的替代品。实际边界应参照 ROLLBACK 和 SAVEPOINT 文档。

如果一个已经存在的保存点包围了可选内部单元，则执行 ROLLBACK TO SAVEPOINT name，然后继续外层事务或释放保存点；保存点以前的工作会保留。没有这样的保存点时，ROLLBACK 会结束失败事务，重试必须从新事务开始。已接受的 25P02 案例 展示根错误 23505、后续 25P02 和恢复；23505 证据 记录更窄的保存点边界。

PL/pgSQL 的 EXCEPTION 块提供另一种窄边界。进入处理器前，块内变更会回滚；块以前的外层变更保留。处理器中，SQLSTATE 和 SQLERRM 表示当前异常；GET STACKED DIAGNOSTICS 可读取 RETURNED_SQLSTATE、主消息、detail、hint、context 和对象字段。参见错误捕获、堆叠诊断 和RAISE。处理器应只包围能够安全分类的操作；WHEN OTHERS 不应抹掉原始字段。

只有在结果边界明确时才重试完整单元

重试是业务决策，不是 SQLSTATE 类别的属性。若序列化失败或死锁等原因具有瞬时性且操作可安全重复，应从新快照重试整个事务。不要只重放最后一条语句，因为前面的读取、写入、锁、通知或外部调用可能共同构成一个业务单元。客户端超时或在收到结果前失联时，服务器可能已经提交但客户端没有响应，完成状态不确定；对外部可见操作应使用幂等键、持久业务键或状态查询后再重复。

遇到权限错误、对象不存在或无效数据时，先检查并修复权限、对象或输入，再判断修正后的操作是否安全。已经完成命令的警告不应触发自动重放。保留第一条诊断和事务状态；随后出现的 25P02 应作为后果记录。退避和尝试次数上限可以控制负载，却不能使非幂等操作变得安全。服务器明确报告超时或取消表示操作失败；客户端在获知结果前失联则属于完成状态不确定的另一类情况。

关联应用与服务器日志

在格式化消息前，记录 SQLSTATE、未本地化 severity、主消息、detail、hint、对象名称、position/context、服务器版本、可用时的 backend PID，以及客户端事务状态。添加应用请求或幂等键和时间戳，便于在服务器日志中找到同一操作。PID、session 标识和 query ID 是关联线索，不能替代协议字段。

CSV 和 JSON 服务器日志是结构化输出，但形状不等同于 ErrorResponse。PostgreSQL 18 的 csvlog 列包含 severity、SQLSTATE、message、detail、hint、context、query、源码位置、application name、backend type 和 query ID。jsonlog 输出 JSON，并可能省略 null 字段；处理器应忽略未来新增字段。按日志文档配置 log_destination 和 logging_collector，再按 PID/session/request 关联，不要假定 CSV 列名或 JSON 键名与协议字段相同。

PL/pgSQL 与自定义条件

RAISE 可以报告 DEBUG、LOG、INFO、NOTICE、WARNING 或 EXCEPTION；EXCEPTION 通常中止当前事务，其他级别只发送消息。它可以指定条件名或五字符 SQLSTATE，并通过 USING 设置 MESSAGE、DETAIL、HINT、SCHEMA、TABLE、COLUMN、DATATYPE 或 CONSTRAINT。PostgreSQL 允许使用除 00000 外、由数字和大写 ASCII 字母组成的任意五字符代码，包括自定义代码。末三位全为零的代码是类别码，只能用整个类别捕获。参见 RAISE 语法。

命名处理器匹配指定条件及其别名；类处理器范围更宽。WHEN OTHERS 捕获除 QUERY_CANCELED 和 ASSERT_FAILURE 以外的所有错误条件；通知级消息不是异常，因此不会被它捕获。PL/pgSQL 主动抛出的自定义代码只能证明该函数有意报告，不能证明 core、contrib、FDW、ECPG 或 driver 自然产生同一代码。

客户端如何暴露诊断

下表固定到已检查的发行版或主文档；不声称本项目对六个客户端都做过运行测试。

跨客户端看，具名异常类、常量和包装类型只是便利映射；跨客户端证据仍是协议 SQLSTATE 和字段。客户端错误消息或 null SQLSTATE 不会覆盖服务器日志中确认的代码。已有 psycopg 3.3.5/libpq 18.6 启动记录中 driver 为 null、服务器为 28P01/53300，只证明这一栈的边界，不能外推到其他五个客户端。

7 - 覆盖范围

覆盖报告会分别统计正式版本定义、预发行快照、中英文配对页面、编辑深度、源码确认和运行案例。生成页面数量不能代替有效的参考内容。

• 规范正式快照：展示 16 个；完整正式历史扫描 351 个；正式 SQLSTATE 并集：263 个。
• 预发行快照：1 个；预发行并集：262 个，其中仅预发行 0 个。
• 双语页面对：263；当前英文到中文的实际修订绑定：263。
• 内容深度：深入 82、参考 181、占位 0；审阅：已审阅 263、待复核 0。
• 选定运行观察（按代码、摘要、用例编号去重）：181；通过 165，不适用 16，失败 0，未运行 0。
• 来源使用状态（按至少有该状态的 code 计数，可重叠）：仅有目录定义 222、源码路径已确认 193、观察到运行时 66、明确未知 183；未知记录按历史 128、自然运行 173、发出路径 12、其他 8 分开（这些是记录数，不是 code 数，不把历史或自然运行未知解释成发出路径未知）；别名 6 个（涉及 6 个 code）。
• 运行观察按代码、摘要、用例编号去重；目标表中的记录适用性（通过/不适用）与其中每个边界断言的结果分别保留。

8 - 方法

范围与锁定输入

大典从 PostgreSQL 发布定义开始，分开记录目录身份、源码实现、官方文档和本地运行观察。锁定 manifest 包含 351 个正式 tag、一个 PostgreSQL 19 Beta 3 预览、19 个定义 blob、263 个代码并集和 44 个类别。公开版本展示矩阵更小，只含 16 个正式大版本快照（9.0–18）和该预览；不能把它当成完整 tag 历史。PostgreSQL 18.6 固定为 REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7，定义路径是 src/backend/utils/errcodes.txt；PostgreSQL 19 Beta 3 是独立预览，固定在 3638289fb57bdabec00deda98ee9624a35f5d66a。

正式历史存在 18.4→18.6 的 tag 缺口。pre-9 收集覆盖 7.0 至 8.4.22 的 191 个 tag，其中 7.4–8.4 有定义文件，7.0–7.3 只有候选路径探测。旧路径缺失是来源缺口，不是代码不存在的证明。known_present_by 是存在边界；只有相邻源码同时证明两侧时才记录精确引入或移除。

证据状态

每条结论都记录所支持的源码路径和固定发布版、tag 或 commit。definition_only 只证明目录身份和历史，不证明报告该码的路径；source_path_confirmed 指向具体调用或实现上下文；observed_runtime 必须有真实运行记录、适用的通过断言和实际 SQLSTATE，源码扫描与跳过案例不能自动升级为运行覆盖。unknown 表示范围尚未解析，不表示绝对缺失。

词法源码候选在采纳前必须回到 C 上下文阅读。私有调用扫描是有界研究输入，不是面向读者的证明。core、contrib、extension、自定义函数、ECPG、driver 和远端服务器路径分开记录。ECPG 或客户端可以复用 PostgreSQL 定义的代码，FDW 或驱动也可能转发远端代码，但这不能证明 server core 在同一操作中报告该代码；反过来，core 路径也不能证明每个 wrapper 或客户端都暴露全部字段。

官方 PO 文本可以确认固定 commit、消息 domain 和占位符边界，但不能证明中文运行输出。locale、driver 行为、服务器版本和消息送达必须分别观察。内部消息和动态字段保留源码条件；翻译或格式化后的字符串永远不是稳定协议键。

运行与恢复边界

运行观察使用隔离的版本化目标，并保留足以识别案例和版本的环境与结构化结果。通过的观察只覆盖所断言的案例和版本；not_run、not_applicable、source-only 以及 driver 为 null 的 SQLSTATE 都明确保留。启动认证或资源失败发生在 SQL 事务之外；即使启动异常没有 driver SQLSTATE，服务器日志也可能记录 SQLSTATE。显式事务中，根错误和后续 25P02 是两条观察；保存点处理器、PL/pgSQL 异常块和完整事务重试具有不同范围。

PL/pgSQL 故意抛出的自定义代码可以展示协议送达和处理器匹配，却不能证明 core、contrib、FDW、ECPG 或 driver 自然报告同一代码。这类观察应标明是故意行为，不应当作自然子系统行为。

翻译与维护

英文是源页面。每个中文页面保留锚点、SQLSTATE 身份、事实、引用、诊断字段和恢复边界，并用自然中文完整传达。中文 front matter 保存英文页面规范化 {title, description, body} 的确定性 UTF-8 SHA-256；英文标题、描述或正文变化后，中文页会过期，直到完成翻译并刷新 revision。生成事实块有明确边界，可从 data/errcodes 刷新；作者正文和证据分开维护。

有价值的维护变更应同时更新固定源码引用、证据状态和两种语言页面。不能从改名的条件、旧 PO 条目、通用 API 签名或客户端 wrapper 推断新的运行机制。公开目录和证据视图只是已接受记录的展示层，不是证据生产过程。

主要记录

公开的版本矩阵、目录、证据索引和运行案例索引展示已接受的投影。维护者使用 reports/CATALOGUE.md、reports/SOURCE-SCAN.md、reports/RUNTIME-BOUNDARIES.md 和 reports/RUNTIME.md 查阅底层记录；这些报告路径是仓库位置，不是公开页面链接。来源 manifest lock 为 sources/manifest.lock.json（SHA-256 1727a275f336988ff96b4f9990a4ca253080f73fc5d316e7def165c8cf3708a8）；pre-9 lock 为 sources/pre9-manifest.lock.json（SHA-256 77bedf102d109972e91ff1b61841d78a38da7c7c049e428782392761a4ce7cd6）。

9 - 00000 — successful_completion

00000 — successful_completion

速览

00000 是成功完成 SQLSTATE。PostgreSQL 错误机制在没有设置更具体代码且级别低于 WARNING 时默认选择它；成功命令不需要错误消息。

含义

elog.c 的 errstart 按消息级别选择默认 SQLSTATE；低于 WARNING 时设置 ERRCODE_SUCCESSFUL_COMPLETION。这是错误机制中的源码级默认值，不是应用错误机制，也不表示普通命令会携带 ErrorResponse。

消息与诊断

命令完成通常由成功结果和命令标签表示，不携带 ErrorResponse SQLSTATE。在固定的 elog 路径中，只有没有更具体代码且消息级别低于 WARNING 时，错误机制才把 00000 作为默认值初始化。诊断消息必须同时保留实际协议消息类型和严重性；00000 不是 ERROR 的默认码，也不会把成功结果变成 ErrorResponse。

诊断

先检查客户端结果状态和命令标签。如果客户端把 00000 与失败状态或 ErrorResponse 一起报告，应调查来源和客户端 API 的状态处理，不能把它解释为通常成功，也不要凭空寻找错误 detail。

处理

将成功命令结果按完成处理。若 NoticeResponse 携带 00000，应把通知与命令结果分开记录；只有两者冲突时才调查客户端状态处理。不要仅因出现此代码就重试成功命令。

版本

锁定目录从 9.0.23 到 18.6 以及 19 Beta 3 均有 00000，known_present_by 为 7.4。18.6 固定的 elog.c 路径显示低于 WARNING 时的默认赋值；这不是每个客户端协议的运行实测。

相关

01000 是警告类；02000 是无数据条件；P0002 是 PL/pgSQL 的 no_data_found。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• elog.c — 固定路径，SHA-256 766d30a426ba1d9597657bd46fb890da3e37e4ae53a83d1245bf082ed9433c33。
• 结构化证据 — 固定来源、消息和运行边界。

10 - 01000 — warning（警告）

速览

01000 是类别 01 Warning 中的通用警告（warning）条件。它只是目录分类，不对应某一个固定子系统或固定报文。PostgreSQL 源码目录明确说明，不应把这个类别用于失败条件。

这个五字符代码必须和协议严重级别及完整诊断一起读取。在 ErrorResponse 或 NoticeResponse 中，S 是可能经过本地化的严重级别，V 是未本地化的严重级别。因此，当产生消息的代码显式提供了该代码时，SQLSTATE 仍可以是 01000，而消息严重级别可能是 WARNING、NOTICE、INFO 或其他提示级别。

在常见的默认路径中，PostgreSQL 将 ereport(WARNING, ...) 映射为 01000，将不低于 ERROR 的级别映射为 XX000，将更低的级别映射为 00000。显式的 errcode() 可以覆盖这个默认值。因此，目录中的 W 标记有参考价值，但单凭它不能证明线上协议消息一定是实际的 WARNING。

代表性案例 generic_warning_boundary 在 PostgreSQL 18.6 和 10.21 上均通过。它用 PL/pgSQL RAISE WARNING 核验默认的 01000 分发，实际收到 WARNING 提示，并保持自动提交连接可继续使用。它没有实测异步 NOTIFY、hstore、XID 或 MultiXact 警告路径。

锁定目录在 PostgreSQL 7.4 的 pre-9.0 正式源码中已经观察到该代码，并确认它存在于 9.0.23 至 18.6 的每个正式快照及 19 Beta 3 预览快照。pre-9.0 源码扫描覆盖 7.4 至 8.4.22；7.0 至 7.3 仍有候选源码缺口。因此，7.4 是已知存在边界，不是精确引入版本。

含义与触发路径

锁定的 18.6 定义是在类别 01 下的 01000 W ERRCODE_WARNING warning。默认严重级别映射位于 elog.c：ERROR 或更高级别从 ERRCODE_INTERNAL_ERROR 开始，WARNING 级别从 ERRCODE_WARNING 开始，更低级别从 ERRCODE_SUCCESSFUL_COMPLETION 开始。随后构造错误消息时还可以替换这个初始代码。

若干真实路径会使用通用警告（warning）代码：

• 异步通知队列会报告 NOTIFY queue is %.0f%% full。如果找到最老的监听事务，还会附带指出 PID 的详细信息，并提示结束该事务。这是队列压力警告，不是数组、权限或约束失败。
• 事务 ID 和 MultiXact 回卷保护会报告某个数据库必须在剩余多少事务或 MultiXact ID 用完前执行 VACUUM。提示会指向全库 VACUUM，以及旧预备事务或陈旧复制槽。
• SPI 清理路径会显式提供 ERRCODE_WARNING，报告非空 SPI 栈，并提示检查遗漏的 SPI_finish。这里的代码是显式指定的，即使严重级别同样是 WARNING。

这些源码确认的例子说明，报文、详细信息、提示、源码上下文和操作比单独的 01000 更有行动价值。其他类别 01 条件（如 01003 或 0100C）拥有自己的 SQLSTATE，不应全部折叠成这个通用代码。

报文与诊断

可执行的代表性案例是注册表中的 generic_warning_boundary：

DO $$ BEGIN RAISE WARNING 'calibration warning'; END $$;
SELECT 1;

PostgreSQL 18.6 和 10.21 都通过提示通道送出这条警告，得到 SQLSTATE 01000、严重级别 WARNING 和主报文 calibration warning。后续的 SELECT 1 成功，连接状态为 IDLE。这是实际的 RAISE WARNING 分发核验，不是上面分别列出的 NOTIFY 队列、hstore 兼容、事务 ID 或 MultiXact 路径的运行时证据。

诊断

从驱动或协议中记录 C/sqlstate、S、V、M、D、H，并同时记录语句、数据库、后端 PID 和时间戳。带有提示处理器的客户端还应记录提示，而不只是异常：WARNING 级别的 NoticeResponse 可以在不抛出语句异常的情况下送达。若有 V，请保留本地化严重级别与未本地化值。

当客户端或服务器日志中看不到消息时，检查 SHOW client_min_messages 和 SHOW log_min_messages。这些设置控制送达与记录阈值，不会改变根因。对于重复出现的警告（warning），使用 SQLSTATE 和稳定的报文模板搜索日志，再检查对应子系统：

• NOTIFY queue ... full 应检查长期存活的监听事务及 DETAIL 中的 PID。
• XID 或 MultiXact 回收警告应在回卷保护变成真实失败之前检查事务年龄、预备事务和复制槽。
• 非空 SPI 栈应指向扩展或服务器端 SPI 生命周期管理。

不能仅凭 01000 推断事务已经中止、连接已经损坏或数据已经损坏。代表性警告让会话保持可用，但后续语句可能因独立原因失败，函数或客户端操作也可能施加自己的控制流。

处理

以报文中的子系统和提示作为修复目标。结束或修复占住通知队列或旧事务回收边界的事务；检查复制槽和预备事务后执行提示的全库维护；或者修复扩展的 SPI 所有权。调查时保留原始诊断。

实际的 WARNING 或更低级别提示本身不会把显式事务置为中止，通常也会让连接保持可继续使用。应验证下一条命令及事务状态，不要从代码本身猜测结果。如果随后出现 ERROR，请按照那个错误的 SQLSTATE 处理，并根据其事务契约使用 ROLLBACK 或合适的保存点恢复。

提高 client_min_messages 或 log_min_messages 可以减少噪声，但不会修复队列、事务回收边界或 SPI 生命周期。只有理解了底层信号后才应考虑抑制它。

版本

目录记录 01000 存在于锁定的 7.4–8.4.22 pre-9.0 正式源码，以及 9.0.23 至 18.6 的所有正式目录快照和 19 Beta 3 预览快照。同 tag 的 REL8_1_4 errcodes.sgml 表已经用较早的 1000 写法列出条件名 warning，因此至少可以确认 8.1.4 已有该条件名。7.0–7.3 仍有候选源码缺口，因此 7.4 观察结果只是存在边界，不是精确引入版本。18.6 源码快照固定在 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7。

协议严重级别字段以及 client_min_messages/log_min_messages 控制项以 PostgreSQL 18 文档为依据。上面的代表性源码路径是 18.6 观察结果，不表示每个旧版本中的所有报文模板都完全不变。

相关

00000 — successful_completion 是低级别完成消息的默认代码。01003 — null_value_eliminated_in_set_function 和 0100C — dynamic_result_sets_returned 是更具体的类别 01 条件。XX000 — internal_error 是没有显式代码的 ERROR 的默认代码，不能与 warning 混用。25P02 — in_failed_sql_transaction 描述的是前一个错误已经中止事务后拒绝后续命令，不能把它当成每个 01000 消息的后果。

来源

本页的结构化证据记录在公开证据 JSON中。源码和文档记录均使用固定 PostgreSQL commit 724edf9bde9d356724ad384a2e196edc3c9f80f7；运行记录保留通过的提示注册表和精确 run ID。

• src.errcodes.18.6 — errcodes.txt
• src.elog.18.6 — elog.c
• src.async.18.6 — async.c
• src.varsup.18.6 与 src.multixact.18.6 — 事务回收边界警告路径
• src.spi.18.6 — SPI 清理路径中的显式警告代码
• doc.protocol.18 与 doc.logging.18 — Error and Notice Message Fields 与 When to Log

11 - 01003 — null_value_eliminated_in_set_function

01003 — null_value_eliminated_in_set_function

速览

01003 是警告类别条件，名称描述集合函数消除 NULL 值。没有解析出 18.6 核心与 contrib 报告组，因此不能确认具体 PostgreSQL 聚合、消息或客户端严重性路径。

含义

定义名称描述集合函数中的 NULL 消除，但固定源码扫描没有定位 PostgreSQL 发射器。来源可能是服务器扩展、客户端或其他实现。

消息与诊断

没有解析出 18.6 消息变体。应保留原始警告文本、语句、聚合或集合函数上下文，以及发出它的服务器或客户端来源。

诊断

先定位发出代码的来源；仅凭 SQLSTATE 无法确定是哪一个聚合或驱动行为。确认来源报告的是 warning、notice 还是只有诊断代码，并把 NULL 消除与查询无行区分开。

处理

如果实际实现文档支持某个设置或表达式调整，应只做该定向修改并验证结果。不要笼统地抑制或重试所有警告。

版本

01003 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 7.4。这是定义存在事实，不是当前服务器发射路径的确认。

相关

01004 是字符串截断警告；02000 是无数据；00000 是成功完成。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• 结构化证据 — 固定来源、消息和运行边界。

12 - 01004 — string_data_right_truncation

01004 — string_data_right_truncation

速览

01004 的名称描述作为警告报告的右截断。没有解析出 18.6 核心与 contrib 报告组，因此不能指定某个转换、编码、客户端或消息。

含义

定义名称描述作为 warning 条件的右截断。没有解析出的调用组时，实际截断行为、数据是否保留以及来源仍未知。

消息与诊断

没有解析出 18.6 消息变体。应保留值和列上下文、声明长度与接收长度（若有）、编码、来源版本及完整诊断。

诊断

定位实际发出代码，并按其长度和编码规则比较传输值。区分保留截断值的 warning 与拒绝语句的 error；SQLSTATE 本身不能决定这种行为。

处理

按来源实现支持的长度或编码调整，并验证数据是否被有意截断。信息可能已经丢失时，不要原样重试输入。

版本

01004 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 7.4。现有证据确认目录事实，不确认当前核心发射路径。

相关

01003 涉及 NULL 消除；01008 涉及零位填充；22001 是独立的错误类别字符串截断。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• 结构化证据 — 固定来源、消息和运行边界。

13 - 01006 — privilege_not_revoked

01006 — privilege_not_revoked

速览

PostgreSQL 18.6 在 src/backend/catalog/aclchk.c 的 REVOKE 路径确认发出 01006。它报告权限变化为空或不完整；命令可以完成，同时发送 warning。

含义

确认的 18.6 实现是 ACL 命令中的 REVOKE 路径，区分没有撤销权限和没有完全撤销权限，并分别使用列级和对象级模板。

消息与诊断

18.6 固定路径的主消息模板为：no privileges could be revoked for column "%s" of relation "%s"、no privileges could be revoked for "%s"、not all privileges could be revoked for column "%s" of relation "%s"、not all privileges could be revoked for "%s"。确认组没有 detail 或 hint。

诊断

记录目标是列还是对象，以及解析后的关系/对象名。在固定 aclchk.c 函数中，this_privileges 是请求权限集合与有效 grantor 可用 grant option 的交集。REVOKE warning 在该掩码为零时是 none，在 !all_privs 且掩码不同于请求时是 partial；这个 warning 分支不会检查 grantee 的旧 ACL。分别检查有效授权者、grant option、请求权限，再检查最终 ACL。WARNING 与会中止命令的 ERROR 不同。

处理

将命令结果和 warning 分开处理。如果目标访问变化没有完成，修正角色、对象或权限并检查 ACL；不改变造成不匹配的条件而重复 REVOKE 可能得到同一 warning。

版本

01006 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 8.0.0。18.6 的固定 warning 路径确认当前消息，不表示所有历史版本措辞相同。

相关

01007 是对应的未授予权限 warning；42501 是权限 error；01000 是警告类。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• aclchk.c — 固定路径，SHA-256 9700258318959b47c42edb423418fb511dd3a008023e732f601eecf4c80868f8。
• 结构化证据 — 固定来源、消息和运行边界。

14 - 01007 — privilege_not_granted

01007 — privilege_not_granted

速览

PostgreSQL 18.6 在 src/backend/catalog/aclchk.c 的 GRANT 路径确认发出 01007。它报告授予为空或不完整，本身不表示 GRANT 以 error 失败。

含义

确认的 18.6 实现是 ACL 命令中的 GRANT 路径，区分没有授予权限和没有完全授予权限，并分别使用列级和对象级模板。

消息与诊断

18.6 固定路径的主消息模板为：no privileges were granted for column "%s" of relation "%s"、no privileges were granted for "%s"、not all privileges were granted for column "%s" of relation "%s"、not all privileges were granted for "%s"。确认组没有 detail 或 hint。

诊断

记录目标是列还是对象，以及确切关系/对象名。在固定 aclchk.c 函数中，this_privileges 是请求权限集合与有效 grantor 可用 grant option 的交集。GRANT warning 在该掩码为零时是 none，在 !all_privs 且掩码不同于请求时是 partial；这个 warning 分支不会检查 grantee 的旧 ACL。分别检查有效授权者、grant option、请求权限，再检查最终 ACL。区分部分 WARNING 与权限 ERROR。

处理

检查 ACL 结果，并修正操作涉及的角色、目标、权限或授予选项。只有在理解权限不匹配后，重新执行相同 GRANT 才有意义。

版本

01007 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 8.0.0。18.6 路径确认当前消息和严重级别，不表示历史措辞一致。

相关

01006 是未撤销权限 warning；42501 是权限 error；01000 是警告类。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• aclchk.c — 固定路径，SHA-256 9700258318959b47c42edb423418fb511dd3a008023e732f601eecf4c80868f8。
• 结构化证据 — 固定来源、消息和运行边界。

15 - 01008 — implicit_zero_bit_padding

01008 — implicit_zero_bit_padding

速览

01008 的名称描述隐式零位填充的警告类别条件。没有解析出 18.6 核心与 contrib 报告组，因此不能确认具体位串转换或消息。

含义

定义名称描述隐式零位填充警告。固定源码扫描没有定位会产生它的转换或接口。

消息与诊断

没有解析出 18.6 消息变体。应保留来源、源和目标位串类型、声明长度及完整诊断。

诊断

定位实际类型转换或驱动路径，并按声明位长比较其填充规则。不要从普通字符串截断或查询无行推断出零位填充。

处理

若填充不是预期行为，使用来源实现支持的显式位长或转换形式并验证结果。warning 代码不表示语句已经回滚。

版本

01008 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 7.4。现有证据只确认定义存在。

相关

01004 涉及字符串截断；01003 涉及 NULL 消除；22021 是编码 error 类。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• 结构化证据 — 固定来源、消息和运行边界。

16 - 0100C — dynamic_result_sets_returned

0100C — dynamic_result_sets_returned

速览

0100C 的名称描述动态结果集返回的警告类别条件。没有解析出 18.6 核心与 contrib 报告组，因此不能确认服务器来源、结果集数量或消息。

含义

定义名称描述动态结果集返回警告。固定源码扫描没有确认来源或结果集协议。

消息与诊断

没有解析出 18.6 消息变体。应保留产生它的例程或接口、结果集数量和顺序、客户端 API，以及完整 warning/notice 诊断。

诊断

确认来源是否是支持动态结果集的过程或客户端接口。没有源码或协议证据时，不要把普通 SQL 批次的多个结果当成此条件。

处理

按实际接口契约消费或声明结果集，或有意调整该契约。一般事务重试不能解决结果集处理问题。

版本

0100C 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 7.4。这是目录证据，不是 18.6 核心发射路径确认。

相关

02001 表示没有额外动态结果集；01000 是警告类；00000 是成功完成。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• 结构化证据 — 固定来源、消息和运行边界。

17 - 01P01 — deprecated_feature

01P01 — deprecated_feature

速览

PostgreSQL 18.6 在设置密码的操作产生或保留 MD5 verifier 时以 WARNING 发出 01P01。这是仍可继续的命令上的弃用通知，不是所有旧功能的通用失败码。

含义

确认的 18.6 实现是 src/backend/libpq/crypt.c 的设置密码路径，在最终 verifier 为 MD5 时发出 warning。触发依据是最终存储的 verifier 形式，例如 password_encryption = 'md5' 下的明文输入，或作为输入传入已有的 md5... verifier；它不是 pg_hba.conf 的认证方法，已有 SCRAM verifier 本身也不会触发此 warning。

消息与诊断

固定路径主消息为 setting an MD5-encrypted password；detail 为 MD5 password support is deprecated and will be removed in a future release of PostgreSQL.；hint 为 Refer to the PostgreSQL documentation for details about migrating to another password type.

诊断

检查设置密码会话中的 SHOW password_encryption、输入是明文还是已有的 md5... verifier，并在有权限时检查角色最终 verifier。保留完整 warning，因为 detail 和 hint 指出了受影响的方法及迁移方向。不要把 pg_hba.conf 的认证方法当成触发条件，也不要把已有 SCRAM verifier 推断为此 warning 的原因。

处理

按官方密码认证文档将受影响角色迁移到 SCRAM；对于明文输入，先将 password_encryption 设为 scram-sha-256，再重置密码，并验证客户端兼容性。不要把旧 MD5 verifier 原样作为迁移步骤。warning 本身不要求原样重试设置密码命令。

版本

01P01 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 8.0.0。固定的 MD5 路径和措辞仅确认 18.6；其他弃用功能或旧措辞需要独立来源。

相关

01000 是警告类；28P01 是密码无效 error；00000 是成功完成。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• crypt.c — 固定路径，SHA-256 d0c7579210827dbaec466f1c064a3d1ea2f7f7bfbf8b40b2e79fb4769cb406a9。
• 结构化证据 — 固定来源、消息和运行边界。

18 - 02000 — no_data

02000 — no_data

速览

02000 在 18.6 的 contrib/amcheck/verify_nbtree.c 中有确认的 DEBUG1/DEBUG2 内部索引检查路径。下面详列的三个组都确认是 DEBUG1；这些诊断不同于普通查询无行，也不是通用客户端错误。

含义

确认的 18.6 实现位于 contrib/amcheck/verify_nbtree.c，索引一致性诊断在 DEBUG1 或 DEBUG2 使用 ERRCODE_NO_DATA。这是内部诊断用途，不是普通 SELECT 无行语义。本证据具体展开三个代表性组；源码中的其他路径不在这组选定消息内。

消息与诊断

本次选定的固定消息组为：

• DEBUG1、内部 errmsg_internal：harmless fast root mismatch in index "%s"，内部 detail 为 Fast root block %u (level %u) differs from true root block %u (level %u).。源码明确把它标为 harmless。
• DEBUG1、内部 errmsg_internal：block %u of index "%s" concurrently deleted。这个分支的确认组没有 detail 或 hint。
• DEBUG1、普通 errmsg/errdetail/errhint：index uniqueness can not be checked for index tid=(%u,%u) in index "%s"，detail 为 It doesn't have visible heap tids and key is equal to the tid=(%u,%u)%s (points to heap tid=(%u,%u)).，hint 为 VACUUM the table and repeat the check.。VACUUM hint 只属于这个组。

诊断

若代码来自 amcheck，记录检查、索引、block/TID 上下文和服务器日志严重级别。fast-root mismatch 已被源码标为 harmless，应结合上下文记录，不要自动当作损坏修复。对于并发删除，应关联并发操作或快照，待相关活动稳定后再决定是否重跑。对于 uniqueness-uncheckable 组，应检查指定索引，并只在该组给出提示时执行 VACUUM 后重跑。应用无行处理应检查实际命令结果或过程条件；PL/pgSQL 的 NO_DATA_FOUND 是 P0002，不是 02000 的通用同义词。

处理

按分支处理：不要把 harmless fast-root 诊断自动变成修复；并发删除要调查并发状态；只有 uniqueness-uncheckable 组给出该提示时，才先执行 VACUUM 再重跑。不要要求每个 DEBUG 发现都做维护，也不要仅因 SQLSTATE 属于 02 类就给普通 SELECT 加无行异常或重试。

版本

02000 在锁定目录 9.0.23 至 18.6 以及 19 Beta 3 中存在，known_present_by 为 7.4。18.6 证据覆盖 amcheck DEBUG 路径；其他来源需要独立源码证据。

相关

P0002 是 PL/pgSQL no_data_found；02001 涉及额外动态结果集；00000 是成功完成。

来源

• errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba.
• verify_nbtree.c — 固定路径，SHA-256 a59ae7540a990e5a70e8eb9cedbcad7c62e3e86b1ad426142c8931ee188b752d。
• 结构化证据 — 固定来源、消息和运行边界。

19 - 02001 — no_additional_dynamic_result_sets_returned