// referencia de errores

Códigos de error de MySQL

Los errores de servidor y cliente de MySQL más frecuentes, cada uno con el texto del mensaje, el símbolo y el SQLSTATE de la referencia de errores de MySQL, qué significa el error y cómo solucionarlo.

Leyendo un error de MySQL

MySQL reporta los errores como ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'. El número es el código de error de MySQL, los cinco caracteres entre corchetes son el SQLSTATE, y el resto es el mensaje con sus marcadores ya sustituidos.

Los códigos del 1000 al 1999 y del 3000 en adelante son generados por el servidor. Los códigos del 2000 al 2999 son generados por la biblioteca del cliente, normalmente porque la conexión no se pudo establecer o se perdió, por lo que el servidor puede que nunca haya visto la instrucción.

Ejecutar SHOW WARNINGS; después de una instrucción para ver advertencias y notas, que usan los mismos números. Muchos errores de datos, como 1265 o 1366, son advertencias en los modos SQL no estrictos y errores en el modo estricto.

Todos los errores de MySQL en esta referencia

79 códigos, 79 con una descripción completa (enlazada). Los códigos y mensajes son de la Referencia de mensajes de error de MySQL 8.4.

Conexión y cliente

CódigoSignificado
2002 No se puede conectar a través del socket CR_CONNECTION_ERROR No se puede conectar al servidor local de MySQL a través del socket '%s' (%d)
2003 No se puede conectar al servidor MySQL en el host CR_CONN_HOST_ERROR No se puede conectar al servidor MySQL en '%s:%u' (%d)
2005 Host del servidor MySQL desconocido CR_UNKNOWN_HOST Host del servidor MySQL desconocido '%s' (%d)
2006 El servidor MySQL se ha ido CR_SERVER_GONE_ERROR El servidor MySQL se ha ido
2013 Se perdió la conexión con el servidor MySQL durante la consulta CR_SERVER_LOST Se perdió la conexión con el servidor MySQL durante la consulta
2055 Se perdió la conexión con el servidor MySQL en la etapa CR_SERVER_LOST_EXTENDED Se perdió la conexión con el servidor MySQL en '%s', error del sistema: %d
2026 Error de conexión SSL CR_SSL_CONNECTION_ERROR Error de conexión SSL: %s
2059 No se puede cargar el complemento de autenticación CR_AUTH_PLUGIN_CANNOT_LOAD No se puede cargar el complemento de autenticación '%s': %s
2061 El complemento de autenticación informó un error CR_AUTH_PLUGIN_ERR El complemento de autenticación '%s' informó un error: %s
1251 El cliente no admite el protocolo de autenticación ER_NOT_SUPPORTED_AUTH_MODE El cliente no admite el protocolo de autenticación solicitado por el servidor; considera actualizar el cliente MySQL
3159 Transporte inseguro prohibido ER_SECURE_TRANSPORT_REQUIRED No se permiten conexiones que usen transporte inseguro mientras --require_secure_transport=ON.
1158 Error al leer paquetes de comunicación ER_NET_READ_ERROR Se produjo un error al leer paquetes de comunicación
1159 Se agotó el tiempo de espera al leer paquetes de comunicación ER_NET_READ_INTERRUPTED Se agotó el tiempo de espera al leer paquetes de comunicación
4031 El servidor te desconectó por inactividad ER_CLIENT_INTERACTION_TIMEOUT El servidor desconectó al cliente por inactividad. Consulta wait_timeout y interactive_timeout para configurar este comportamiento.

Acceso y privilegios

CódigoSignificado
1045 Acceso denegado para el usuario ER_ACCESS_DENIED_ERROR Acceso denegado para el usuario '%s'@'%s' (usando contraseña: %s)
1044 Acceso denegado para el usuario a la base de datos ER_DBACCESS_DENIED_ERROR Acceso denegado para el usuario '%s'@'%s' a la base de datos '%s'
1130 El host no tiene permitido conectarse ER_HOST_NOT_PRIVILEGED El host '%s' no tiene permitido conectarse a este servidor MySQL
1698 Acceso denegado para el usuario (sin contraseña) ER_ACCESS_DENIED_NO_PASSWORD_ERROR Acceso denegado para el usuario '%s'@'%s'
1142 Comando denegado al usuario para la tabla ER_TABLEACCESS_DENIED_ERROR Comando %s denegado al usuario '%s'@'%s' para la tabla '%s'
1143 Comando denegado al usuario para la columna ER_COLUMNACCESS_DENIED_ERROR Comando %s denegado al usuario '%s'@'%s' para la columna '%s' en la tabla '%s'
1227 Acceso denegado; necesitas un privilegio ER_SPECIFIC_ACCESS_DENIED_ERROR Acceso denegado; necesitas (al menos uno de) los privilegios %s para esta operación
1396 La operación CREATE USER falló ER_CANNOT_USER La operación %s falló para %s
1419 Se requiere el privilegio SUPER con registro binario ER_BINLOG_CREATE_ROUTINE_NEED_SUPER No tienes el privilegio SUPER y el registro binario está habilitado (quizá *quieras* usar la variable menos segura log_bin_trust_function_creators)
1449 El usuario definidor no existe ER_NO_SUCH_USER El usuario especificado como definidor ('%s'@'%s') no existe

Sintaxis e instrucciones

CódigoSignificado
1064 Tienes un error en la sintaxis SQL ER_PARSE_ERROR %s cerca de '%s' en la línea %d
1149 Error de sintaxis SQL ER_SYNTAX_ERROR Tienes un error en la sintaxis de SQL; verifica el manual que corresponde a la versión de tu servidor MySQL para usar la sintaxis correcta
1052 La columna es ambigua ER_NON_UNIQ_ERROR La columna '%s' en %s es ambigua
1055 La expresión no está en GROUP BY ER_WRONG_FIELD_WITH_GROUP '%s' no está en GROUP BY
1093 No se puede especificar la tabla de destino para la actualización ER_UPDATE_TABLE_USED No puedes especificar la tabla de destino '%s' para la actualización en la cláusula FROM
1136 El número de columnas no coincide con el número de valores ER_WRONG_VALUE_COUNT_ON_ROW El número de columnas no coincide con el número de valores en la fila %ld
1242 La subconsulta devuelve más de 1 fila ER_SUBQUERY_NO_1_ROW La subconsulta devuelve más de 1 fila
1248 Cada tabla derivada debe tener su propio alias ER_DERIVED_MUST_HAVE_ALIAS Cada tabla derivada debe tener su propio alias
1318 Número incorrecto de argumentos ER_SP_WRONG_NO_OF_ARGS Número incorrecto de argumentos para %s %s; se esperaban %u, se recibieron %u

Bases de datos, tablas y columnas

CódigoSignificado
1049 Base de datos desconocida ER_BAD_DB_ERROR Base de datos desconocida '%s'
1046 No se ha seleccionado ninguna base de datos ER_NO_DB_ERROR No se ha seleccionado ninguna base de datos
1054 Columna desconocida en la lista de campos ER_BAD_FIELD_ERROR Columna desconocida '%s' en '%s'
1146 La tabla no existe ER_NO_SUCH_TABLE La tabla '%s.%s' no existe
1050 La tabla ya existe ER_TABLE_EXISTS_ERROR La tabla '%s' ya existe
1051 Tabla desconocida ER_BAD_TABLE_ERROR Tabla desconocida '%s'
1060 Nombre de columna duplicado ER_DUP_FIELDNAME Nombre de columna duplicado '%s'
1091 No se puede DROP; comprueba que la columna/clave exista ER_CANT_DROP_FIELD_OR_KEY No se puede DROP '%s'; comprueba que la columna/clave exista
1305 La función o el procedimiento no existe ER_SP_DOES_NOT_EXIST %s %s no existe
1442 El disparador no puede actualizar su propia tabla ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG No se puede actualizar la tabla '%s' en la función/trigger almacenado porque ya la está usando la instrucción que invocó esta función/trigger almacenado.

Claves y restricciones

CódigoSignificado
1062 Entrada duplicada para la clave ER_DUP_ENTRY Entrada duplicada '%s' para la clave %d
1061 Nombre de clave duplicado ER_DUP_KEYNAME Nombre de clave duplicado '%s'
1452 Error de clave foránea: no se puede añadir la fila hija ER_NO_REFERENCED_ROW_2 No se puede añadir o actualizar una fila hija: falla la restricción de clave foránea%s
1451 Error de clave foránea: no se puede eliminar la fila padre ER_ROW_IS_REFERENCED_2 No se puede eliminar o actualizar una fila padre: falla la restricción de clave foránea%s
1216 No se puede añadir o actualizar una fila hija ER_NO_REFERENCED_ROW No se puede añadir o actualizar una fila hija: falla la restricción de clave foránea
1217 No se puede eliminar o actualizar una fila padre ER_ROW_IS_REFERENCED No se puede eliminar o actualizar una fila padre: falla la restricción de clave foránea
1215 No se puede añadir la restricción de clave foránea ER_CANNOT_ADD_FOREIGN No se puede añadir la restricción de clave foránea
3780 Las columnas de clave foránea son incompatibles ER_FK_INCOMPATIBLE_COLUMNS La columna de referencia '%s' y la columna referenciada '%s' en la restricción de clave foránea '%s' son incompatibles.
1822 Falta un índice para la restricción de clave foránea ER_FK_NO_INDEX_PARENT Error al añadir la restricción de clave foránea. Falta un índice para la restricción '%s' en la tabla referenciada '%s'
1824 Error al abrir la tabla referenciada ER_FK_CANNOT_OPEN_PARENT Error al abrir la tabla referenciada '%s'
1048 La columna no puede ser nula ER_BAD_NULL_ERROR La columna '%s' no puede ser nula
3819 Se violó la restricción CHECK ER_CHECK_CONSTRAINT_VIOLATED Se violó la restricción CHECK '%s'.
1071 La clave especificada era demasiado larga ER_TOO_LONG_KEY La clave especificada era demasiado larga; la longitud máxima de la clave es de %d bytes
1075 Solo se permite una columna automática, y debe ser una clave ER_WRONG_AUTO_KEY Definición de tabla incorrecta; solo puede haber una columna automática y debe definirse como clave
1701 No se puede truncar una tabla con claves foráneas ER_TRUNCATE_ILLEGAL_FK No se puede truncar una tabla referenciada en una restricción de clave foránea (%s)
1586 Entrada duplicada para la clave (con nombre de clave) ER_DUP_ENTRY_WITH_KEY_NAME Entrada duplicada '%s' para la clave '%s'
1826 Nombre de restricción de clave foránea duplicado ER_FK_DUP_NAME Nombre de restricción de clave foránea duplicado '%s'

Valores de datos

CódigoSignificado
1364 El campo no tiene un valor predeterminado ER_NO_DEFAULT_FOR_FIELD El campo '%s' no tiene un valor predeterminado
1366 Valor incorrecto para la columna ER_TRUNCATED_WRONG_VALUE_FOR_FIELD Valor %s incorrecto: '%s' para la columna '%s' en la fila %ld
1406 Datos demasiado largos para la columna ER_DATA_TOO_LONG Datos demasiado largos para la columna '%s' en la fila %ld
1292 Valor incorrecto truncado ER_TRUNCATED_WRONG_VALUE Valor %s incorrecto truncado: '%s'
1264 Valor fuera de rango para la columna ER_WARN_DATA_OUT_OF_RANGE Valor fuera de rango para la columna '%s' en la fila %ld
1265 Datos truncados para la columna WARN_DATA_TRUNCATED Datos truncados para la columna '%s' en la fila %ld
1067 Valor predeterminado no válido ER_INVALID_DEFAULT Valor predeterminado no válido para '%s'

Transacciones y bloqueo

CódigoSignificado
1205 Tiempo de espera de bloqueo excedido ER_LOCK_WAIT_TIMEOUT Tiempo de espera de bloqueo excedido; intenta reiniciar la transacción
1213 Se detectó un interbloqueo al intentar obtener el bloqueo ER_LOCK_DEADLOCK Se detectó un interbloqueo al intentar obtener el bloqueo; intenta reiniciar la transacción
3572 No se pudo obtener el bloqueo con NOWAIT ER_LOCK_NOWAIT La instrucción se abortó porque no se pudieron adquirir los bloqueos de inmediato y NOWAIT está activado.
1206 Los bloqueos exceden el tamaño de la tabla de bloqueos ER_LOCK_TABLE_FULL El número total de bloqueos supera el tamaño de la tabla de bloqueos
1792 Escribir en una transacción READ ONLY ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION No se puede ejecutar la instrucción en una transacción de SOLO LECTURA.
3024 Se superó el tiempo máximo de ejecución de la instrucción ER_QUERY_TIMEOUT La ejecución de la consulta se interrumpió: se superó el tiempo máximo de ejecución de la instrucción

Límites y ajustes del servidor

CódigoSignificado
1040 Demasiadas conexiones ER_CON_COUNT_ERROR Demasiadas conexiones
1203 El usuario tiene más de max_user_connections ER_TOO_MANY_USER_CONNECTIONS El usuario %s ya tiene más de 'max_user_connections' conexiones activas
1153 Se recibió un paquete más grande que max_allowed_packet ER_NET_PACKET_TOO_LARGE Se recibió un paquete más grande que 'max_allowed_packet' bytes
1175 El modo de actualización segura bloqueó la instrucción ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE Estás usando el modo de actualización segura e intentaste actualizar una tabla sin un WHERE que use una columna KEY. %s
1290 La opción del servidor impide esta instrucción ER_OPTION_PREVENTS_STATEMENT El servidor MySQL se está ejecutando con la opción %s, por lo que no puede ejecutar esta instrucción
1114 La tabla está llena ER_RECORD_FILE_FULL La tabla '%s' está llena
// un cliente, todos los motores

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

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