// referencia de errores

Códigos de error de PostgreSQL

Todos los códigos SQLSTATE que PostgreSQL puede generar, agrupados por clase como en el apéndice oficial. Los que la gente realmente encuentra tienen una página completa: qué significa el error, por qué ocurre y cómo solucionarlo.

Leyendo un error de PostgreSQL

PostgreSQL identifica cada error con un código SQLSTATE de cinco caracteres. Los dos primeros caracteres indican la clase: 23 es violación de restricción de integridad, 42 es un error de sintaxis o una violación de regla de acceso, 40 es una reversión de transacción, y así sucesivamente. Los códigos que terminan en 000 son el código genérico de su clase.

psql muestra el mensaje, no el código. Ejecuta \set VERBOSITY verbose para ver el SQLSTATE, o léelo desde tu controlador: SQLSTATE en JDBC y ODBC, e.pgcode en psycopg2, e.sqlstate en psycopg 3, err.code en node-postgres.

En PL/pgSQL puedes capturar un error por el nombre de la condición (EXCEPTION WHEN unique_violation THEN) o por código (WHEN SQLSTATE '23505' THEN).

Todos los errores de PostgreSQL en esta referencia

262 códigos, 63 con una descripción completa (enlazada). Los códigos y mensajes son de la documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL.

Finalización con éxito

CódigoSignificado
00000 successful_completion

Advertencia

CódigoSignificado
01000 warning
0100C dynamic_result_sets_returned
01008 implicit_zero_bit_padding
01003 null_value_eliminated_in_set_function
01007 privilege_not_granted
01006 privilege_not_revoked
01004 string_data_right_truncation
01P01 deprecated_feature

Sin Datos (esto también es una clase de advertencia según el estándar SQL)

CódigoSignificado
02000 no_data
02001 no_additional_dynamic_result_sets_returned

Instrucción SQL aún incompleta

CódigoSignificado
03000 sql_statement_not_yet_complete

Excepción de conexión

CódigoSignificado
08000 connection_exception
08003 connection_does_not_exist
08006 fallo de conexión connection_failure el servidor cerró la conexión inesperadamente Esto probablemente significa que el servidor terminó de manera anormal antes o mientras se procesaba la solicitud.
08001 no se pudo establecer la conexión sqlclient_unable_to_establish_sqlconnection la conexión con el servidor en "db.example.com" (10.0.0.5), puerto 5432 falló: Conexión rechazada ¿Está el servidor ejecutándose en ese host y aceptando conexiones TCP/IP?
08004 sqlserver_rejected_establishment_of_sqlconnection
08007 transaction_resolution_unknown
08P01 protocol_violation

Excepción de acción activada

CódigoSignificado
09000 triggered_action_exception

Función no admitida

CódigoSignificado
0A000 característica no admitida feature_not_supported las referencias entre bases de datos no están implementadas: "otherdb.public.orders"

Inicio de transacción no válido

CódigoSignificado
0B000 invalid_transaction_initiation

Excepción de localizador

CódigoSignificado
0F000 locator_exception
0F001 invalid_locator_specification

Otorgante no válido

CódigoSignificado
0L000 invalid_grantor
0LP01 operación de concesión no válida invalid_grant_operation las opciones de concesión solo se pueden otorgar a roles

Especificación de rol no válida

CódigoSignificado
0P000 invalid_role_specification

Excepción de diagnóstico

CódigoSignificado
0Z000 diagnostics_exception
0Z002 stacked_diagnostics_accessed_without_active_handler

Error de XQuery

CódigoSignificado
10608 invalid_argument_for_xquery

Caso no encontrado

CódigoSignificado
20000 case_not_found

Violación de cardinalidad

CódigoSignificado
21000 más de una fila devuelta por una subconsulta cardinality_violation más de una fila devuelta por una subconsulta utilizada como expresión

Excepción de datos

CódigoSignificado
22000 data_exception
2202E array_subscript_error
22021 secuencia de bytes no válida para la codificación character_not_in_repertoire secuencia de bytes no válida para la codificación "UTF8": 0xff
22008 valor del campo fecha/hora fuera de rango datetime_field_overflow valor del campo fecha/hora fuera de rango: "2026-13-01"
22012 división por cero division_by_zero división por cero
22005 error_in_assignment
2200B escape_character_conflict
22022 indicator_overflow
22015 interval_field_overflow
2201E invalid_argument_for_logarithm
22014 invalid_argument_for_ntile_function
22016 invalid_argument_for_nth_value_function
2201F invalid_argument_for_power_function
2201G invalid_argument_for_width_bucket_function
22018 invalid_character_value_for_cast
22007 formato de fecha/hora no válido invalid_datetime_format sintaxis de entrada no válida para el tipo timestamp: "31/12/2026 25:00"
22019 invalid_escape_character
2200D invalid_escape_octet
22025 invalid_escape_sequence
22P06 nonstandard_use_of_escape_character
22010 invalid_indicator_parameter_value
22023 valor de parámetro no válido invalid_parameter_value valor no válido para el parámetro "TimeZone": "Mars/Olympus"
22013 invalid_preceding_or_following_size
2201B invalid_regular_expression
2201W invalid_row_count_in_limit_clause
2201X invalid_row_count_in_result_offset_clause
2202H invalid_tablesample_argument
2202G invalid_tablesample_repeat
22009 invalid_time_zone_displacement_value
2200C invalid_use_of_escape_character
2200G most_specific_type_mismatch
22004 null_value_not_allowed
22002 null_value_no_indicator_parameter
22003 valor numérico fuera de rango numeric_value_out_of_range entero fuera de rango
2200H sequence_generator_limit_exceeded
22026 string_data_length_mismatch
22001 valor demasiado largo para el tipo string_data_right_truncation valor demasiado largo para el tipo character varying(20)
22011 substring_error
22027 trim_error
22024 unterminated_c_string
2200F zero_length_character_string
22P01 floating_point_exception
22P02 sintaxis de entrada no válida para el tipo invalid_text_representation sintaxis de entrada no válida para el tipo integer: "abc"
22P03 invalid_binary_representation
22P04 bad_copy_file_format
22P05 untranslatable_character
2200L not_an_xml_document
2200M invalid_xml_document
2200N invalid_xml_content
2200S invalid_xml_comment
2200T invalid_xml_processing_instruction
22030 duplicate_json_object_key_value
22031 invalid_argument_for_sql_json_datetime_function
22032 invalid_json_text
22033 invalid_sql_json_subscript
22034 more_than_one_sql_json_item
22035 no_sql_json_item
22036 non_numeric_sql_json_item
22037 non_unique_keys_in_a_json_object
22038 singleton_sql_json_item_required
22039 sql_json_array_not_found
2203A sql_json_member_not_found
2203B sql_json_number_not_found
2203C sql_json_object_not_found
2203D too_many_json_array_elements
2203E too_many_json_object_members
2203F sql_json_scalar_required
2203G sql_json_item_cannot_be_cast_to_target_type

Violación de restricción de integridad

CódigoSignificado
23000 integrity_constraint_violation
23001 restrict_violation
23502 valor nulo viola la restricción de no nulo not_null_violation valor nulo en la columna "email" de la relación "users" viola la restricción de no nulo DETALLE: La fila que falla contiene (7, Ada, null).
23503 violación de restricción de clave foránea foreign_key_violation insertar o actualizar en la tabla "orders" viola la restricción de clave foránea "orders_customer_id_fkey" DETALLE: La clave (customer_id)=(42) no está presente en la tabla "customers".
23505 clave duplicada viola la restricción única unique_violation el valor de clave duplicada viola la restricción única "users_email_key" DETALLE: La clave (email)=([email protected]) ya existe.
23514 violación de la restricción CHECK check_violation nueva fila para la relación "orders" viola la restricción de comprobación "orders_qty_check" DETALLE: La fila que falla contiene (12, -1).
23P01 violación de la restricción de exclusión exclusion_violation valor de clave conflictivo viola la restricción de exclusión "bookings_room_during_excl" DETALLE: La clave (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) entra en conflicto con la clave existente (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).

Estado de cursor no válido

CódigoSignificado
24000 invalid_cursor_state

Estado de transacción no válido

CódigoSignificado
25000 invalid_transaction_state
25001 no se puede ejecutar dentro de un bloque de transacción active_sql_transaction CREATE INDEX CONCURRENTLY no se puede ejecutar dentro de un bloque de transacción
25002 branch_transaction_already_active
25008 held_cursor_requires_same_isolation_level
25003 inappropriate_access_mode_for_branch_transaction
25004 inappropriate_isolation_level_for_branch_transaction
25005 no_active_sql_transaction_for_branch_transaction
25006 transacción SQL de solo lectura read_only_sql_transaction no se puede ejecutar INSERT en una transacción de solo lectura
25007 schema_and_data_statement_mixing_not_supported
25P01 no_active_sql_transaction
25P02 la transacción actual está abortada in_failed_sql_transaction la transacción actual ha sido abortada, comandos ignorados hasta el fin del bloque de transacción
25P03 tiempo de espera de sesión inactiva en transacción idle_in_transaction_session_timeout terminando conexión debido a tiempo de espera de inactividad en transacción
25P04 transaction_timeout

Nombre de instrucción SQL no válido

CódigoSignificado
26000 invalid_sql_statement_name

Violación de cambio de datos activada

CódigoSignificado
27000 triggered_data_change_violation

Especificación de autorización no válida

CódigoSignificado
28000 especificación de autorización no válida invalid_authorization_specification no hay entrada en pg_hba.conf para el host "10.0.0.5", usuario "app", base de datos "shop", sin cifrado
28P01 fallo de autenticación de contraseña invalid_password password authentication failed for user "app"

Aún existen descriptores de privilegios dependientes

CódigoSignificado
2B000 dependent_privilege_descriptors_still_exist
2BP01 aún existen objetos dependientes dependent_objects_still_exist no se puede eliminar la tabla customers porque otros objetos dependen de ella DETALLE: la restricción orders_customer_id_fkey en la tabla orders depende de la tabla customers SUGERENCIA: Usa DROP ... CASCADE para eliminar también los objetos dependientes.

Terminación de transacción no válida

CódigoSignificado
2D000 terminación de transacción no válida invalid_transaction_termination terminación de transacción no válida

Excepción de Rutina SQL

CódigoSignificado
2F000 sql_routine_exception
2F005 function_executed_no_return_statement
2F002 modifying_sql_data_not_permitted
2F003 prohibited_sql_statement_attempted
2F004 reading_sql_data_not_permitted

Nombre de cursor no válido

CódigoSignificado
34000 invalid_cursor_name

Excepción de rutina externa

CódigoSignificado
38000 external_routine_exception
38001 containing_sql_not_permitted
38002 modifying_sql_data_not_permitted
38003 prohibited_sql_statement_attempted
38004 reading_sql_data_not_permitted

Excepción de invocación de rutina externa

CódigoSignificado
39000 external_routine_invocation_exception
39001 invalid_sqlstate_returned
39004 null_value_not_allowed
39P01 trigger_protocol_violated
39P02 srf_protocol_violated
39P03 event_trigger_protocol_violated

Excepción de punto de guardado

CódigoSignificado
3B000 savepoint_exception
3B001 especificación de savepoint no válida invalid_savepoint_specification el savepoint "before_update" no existe

Nombre de catálogo no válido

CódigoSignificado
3D000 la base de datos no existe invalid_catalog_name la base de datos "shop" no existe

Nombre de esquema no válido

CódigoSignificado
3F000 el esquema no existe invalid_schema_name el esquema "sales" no existe

Reversión de transacción

CódigoSignificado
40000 transaction_rollback
40002 transaction_integrity_constraint_violation
40001 no se pudo serializar el acceso serialization_failure no se pudo serializar el acceso debido a una actualización concurrente
40003 statement_completion_unknown
40P01 se detectó un interbloqueo deadlock_detected se detectó un interbloqueo DETALLE: El proceso 1234 espera un ShareLock en la transacción 5678; bloqueado por el proceso 4321. El proceso 4321 espera un ShareLock en la transacción 8765; bloqueado por el proceso 1234.

Error de sintaxis o violación de regla de acceso

CódigoSignificado
42000 syntax_error_or_access_rule_violation
42601 error de sintaxis en o cerca de syntax_error error de sintaxis en o cerca de "FROM" LÍNEA 1: SELECT id, name, FROM users; ^
42501 permiso denegado insufficient_privilege permission denied for table orders
42846 no se puede forzar cannot_coerce no se puede convertir el tipo integer a uuid
42803 la columna debe aparecer en la cláusula GROUP BY grouping_error la columna "o.customer_id" debe aparecer en la cláusula GROUP BY o usarse en una función de agregación
42P20 windowing_error
42P19 invalid_recursion
42830 clave foránea no válida invalid_foreign_key no existe una restricción única que coincida con las claves dadas para la tabla referenciada "customers"
42602 invalid_name
42622 name_too_long
42939 reserved_name
42804 incompatibilidad de tipos de datos datatype_mismatch la columna "created_at" es de tipo timestamp with time zone pero la expresión es de tipo integer SUGERENCIA: Tendrás que reescribir o convertir la expresión.
42P18 no se pudo determinar el tipo de datos del parámetro indeterminate_datatype no se pudo determinar el tipo de datos del parámetro $1
42P21 collation_mismatch
42P22 indeterminate_collation
42809 wrong_object_type
428C9 generated_always
42703 la columna no existe undefined_column la columna "emial" no existe LÍNEA 1: SELECT emial FROM users; ^ SUGERENCIA: Quizás querías referirte a la columna "users.email".
42883 la función no existe undefined_function función lower(integer) no existe LÍNEA 1: SELECT lower(42); ^ SUGERENCIA: Ninguna función coincide con el nombre y los tipos de argumento dados. Quizá necesites añadir conversiones de tipo explícitas.
42P01 la relación no existe undefined_table la relación "orders" no existe LÍNEA 1: SELECT * FROM orders; ^
42P02 no hay parámetro undefined_parameter no hay parámetro $1
42704 objeto indefinido undefined_object el tipo "jsonbb" no existe
42701 duplicate_column
42P03 duplicate_cursor
42P04 la base de datos ya existe duplicate_database la base de datos "shop" ya existe
42723 duplicate_function
42P05 duplicate_prepared_statement
42P06 el esquema ya existe duplicate_schema el esquema "sales" ya existe
42P07 la relación ya existe duplicate_table la relación "orders" ya existe
42712 duplicate_alias
42710 objeto duplicado duplicate_object el rol "app" ya existe
42702 la referencia de columna es ambigua ambiguous_column la referencia de columna "id" es ambigua LÍNEA 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id; ^
42725 ambiguous_function
42P08 ambiguous_parameter
42P09 ambiguous_alias
42P10 referencia de columna no válida invalid_column_reference no existe restricción única o de exclusión que coincida con la especificación ON CONFLICT
42611 invalid_column_definition
42P11 invalid_cursor_definition
42P12 invalid_database_definition
42P13 invalid_function_definition
42P14 invalid_prepared_statement_definition
42P15 invalid_schema_definition
42P16 invalid_table_definition
42P17 invalid_object_definition

Infracción de la opción WITH CHECK

CódigoSignificado
44000 with_check_option_violation

Recursos insuficientes

CódigoSignificado
53000 insufficient_resources
53100 disco lleno disk_full no se pudo ampliar el archivo "base/16384/16397": No queda espacio en el dispositivo SUGERENCIA: Comprueba el espacio libre en disco.
53200 memoria agotada out_of_memory out of memory DETAIL: Failed on request of size 1048576 in memory context "ExecutorState".
53300 demasiadas conexiones too_many_connections lo siento, ya hay demasiados clientes
53400 configuration_limit_exceeded

Límite del programa excedido

CódigoSignificado
54000 límite de programa excedido program_limit_exceeded el tamaño de la fila del índice 3200 excede el máximo de 2704 de la versión 4 de btree para el índice "documents_body_idx" DETALLE: La fila del índice hace referencia a la tupla (12,3) en la relación "documents". SUGERENCIA: Los valores mayores que 1/3 de una página de búfer no se pueden indexar. Considera un índice de función sobre un hash MD5 del valor, o usa la indexación de texto completo.
54001 statement_too_complex
54011 too_many_columns
54023 too_many_arguments

El objeto no está en el estado de prerrequisito

CódigoSignificado
55000 el objeto no está en el estado previo requerido object_not_in_prerequisite_state currval de la secuencia "orders_id_seq" aún no está definido en esta sesión
55006 objeto en uso object_in_use la base de datos "shop" está siendo accedida por otros usuarios DETALLE: Hay 1 sesión más utilizando la base de datos.
55P02 cant_change_runtime_param
55P03 bloqueo no disponible lock_not_available no se pudo obtener el bloqueo en la fila de la relación "orders"
55P04 unsafe_new_enum_value_usage

Intervención del operador

CódigoSignificado
57000 operator_intervention
57014 cancelando instrucción query_canceled cancelando instrucción debido al tiempo de espera de la instrucción
57P01 terminando conexión debido a administrador admin_shutdown terminando conexión debido a comando del administrador
57P02 crash_shutdown
57P03 no se puede conectar ahora cannot_connect_now el sistema de base de datos se está iniciando
57P04 database_dropped
57P05 idle_session_timeout

Error del sistema (errores externos a PostgreSQL en sí)

CódigoSignificado
58000 system_error
58030 io_error
58P01 archivo indefinido undefined_file no se pudo abrir el archivo "/tmp/orders.csv" para lectura: No existe dicho archivo o directorio
58P02 duplicate_file
58P03 file_name_too_long

Error de archivo de configuración

CódigoSignificado
F0000 config_file_error
F0001 lock_file_exists

Error del wrapper de datos externos (SQL/MED)

CódigoSignificado
HV000 fdw_error
HV005 fdw_column_name_not_found
HV002 fdw_dynamic_parameter_value_needed
HV010 fdw_function_sequence_error
HV021 fdw_inconsistent_descriptor_information
HV024 fdw_invalid_attribute_value
HV007 fdw_invalid_column_name
HV008 fdw_invalid_column_number
HV004 fdw_invalid_data_type
HV006 fdw_invalid_data_type_descriptors
HV091 fdw_invalid_descriptor_field_identifier
HV00B fdw_invalid_handle
HV00C fdw_invalid_option_index
HV00D fdw_invalid_option_name
HV090 fdw_invalid_string_length_or_buffer_length
HV00A fdw_invalid_string_format
HV009 fdw_invalid_use_of_null_pointer
HV014 fdw_too_many_handles
HV001 fdw_out_of_memory
HV00P fdw_no_schemas
HV00J fdw_option_name_not_found
HV00K fdw_reply_handle
HV00Q fdw_schema_not_found
HV00R fdw_table_not_found
HV00L fdw_unable_to_create_execution
HV00M fdw_unable_to_create_reply
HV00N fdw_unable_to_establish_connection

Error de PL/pgSQL

CódigoSignificado
P0000 plpgsql_error
P0001 generar excepción raise_exception fondos insuficientes para la cuenta 42
P0002 no_data_found
P0003 too_many_rows
P0004 assert_failure

Error interno

CódigoSignificado
XX000 error interno internal_error la búsqueda en caché falló para la relación 16397
XX001 datos corruptos data_corrupted página no válida en el bloque 1234 de la relación base/16384/16397
XX002 index_corrupted
// un cliente, todos los motores

Una forma más rápida de trabajar con PostgreSQL

SQLly es un cliente SQL nativo para macOS, Windows y Linux, con IntelliSense que entiende el esquema y protecciones frente a instrucciones peligrosas.