// справочник ошибок

Коды ошибок MySQL

Ошибки сервера и клиента MySQL, которые встречаются чаще всего: для каждой — текст сообщения, символ и SQLSTATE из справочника ошибок MySQL, объяснение, что она значит, и как её исправить.

Чтение ошибки MySQL

MySQL сообщает об ошибках как ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'. Число — это код ошибки MySQL, пять символов в скобках — SQLSTATE, а остальное — сообщение с уже подставленными значениями.

Коды от 1000 до 1999 и от 3000 и выше выдаёт сервер. Коды от 2000 до 2999 выдаёт клиентская библиотека — обычно соединиться не удалось или соединение оборвалось, так что сервер мог вообще не увидеть этот оператор.

Выполнить SHOW WARNINGS; после оператора, чтобы увидеть предупреждения и замечания, у которых те же номера. Многие ошибки данных, например 1265 или 1366, в нестрогом режиме SQL считаются предупреждениями, а в строгом режиме — ошибками.

Все ошибки MySQL в этом справочнике

79 кодов, 79 с полным разбором (со ссылкой). Коды и сообщения взяты из Справочник сообщений об ошибках MySQL 8.4.

Соединение и клиент

КодЗначение
2002 Не удается подключиться через сокет CR_CONNECTION_ERROR Не удается подключиться к локальному серверу MySQL через сокет '%s' (%d)
2003 Не удается подключиться к серверу MySQL на хосте CR_CONN_HOST_ERROR Не удается подключиться к серверу MySQL на '%s:%u' (%d)
2005 Неизвестный хост сервера MySQL CR_UNKNOWN_HOST Неизвестный хост сервера MySQL '%s' (%d)
2006 Сервер MySQL перестал отвечать CR_SERVER_GONE_ERROR Сервер MySQL перестал отвечать
2013 Потеряно соединение с сервером MySQL во время выполнения запроса CR_SERVER_LOST Потеряно соединение с сервером MySQL во время выполнения запроса
2055 Потеряно соединение с сервером MySQL на этапе CR_SERVER_LOST_EXTENDED Потеряно соединение с сервером MySQL на '%s', системная ошибка: %d
2026 Ошибка SSL-соединения CR_SSL_CONNECTION_ERROR Ошибка SSL-соединения: %s
2059 Плагин аутентификации не может быть загружен CR_AUTH_PLUGIN_CANNOT_LOAD Плагин аутентификации '%s' не может быть загружен: %s
2061 Плагин аутентификации сообщил об ошибке CR_AUTH_PLUGIN_ERR Плагин аутентификации '%s' сообщил об ошибке: %s
1251 Клиент не поддерживает протокол аутентификации ER_NOT_SUPPORTED_AUTH_MODE Клиент не поддерживает протокол аутентификации, запрошенный сервером; возможно, стоит обновить клиент MySQL
3159 Небезопасный транспорт запрещён ER_SECURE_TRANSPORT_REQUIRED Подключения через незащищённый транспорт запрещены, пока действует --require_secure_transport=ON.
1158 Ошибка чтения пакетов связи ER_NET_READ_ERROR Произошла ошибка при чтении пакетов связи
1159 Превышено время ожидания при чтении пакетов связи ER_NET_READ_INTERRUPTED Превышено время ожидания при чтении пакетов связи
4031 Отключено сервером из-за неактивности ER_CLIENT_INTERACTION_TIMEOUT Клиент был отключен сервером из-за неактивности. См. wait_timeout и interactive_timeout для настройки этого поведения.

Доступ и привилегии

КодЗначение
1045 Доступ запрещен для пользователя ER_ACCESS_DENIED_ERROR Доступ запрещен для пользователя '%s'@'%s' (используется пароль: %s)
1044 Доступ запрещен для пользователя к базе данных ER_DBACCESS_DENIED_ERROR Доступ запрещен для пользователя '%s'@'%s' к базе данных '%s'
1130 Хосту не разрешено подключение ER_HOST_NOT_PRIVILEGED Хосту '%s' не разрешено подключаться к этому серверу MySQL
1698 Доступ запрещен для пользователя (без пароля) ER_ACCESS_DENIED_NO_PASSWORD_ERROR Доступ запрещен для пользователя '%s'@'%s'
1142 Команда запрещена пользователю для таблицы ER_TABLEACCESS_DENIED_ERROR %s команда запрещена для пользователя '%s'@'%s' для таблицы '%s'
1143 Команда запрещена пользователю для столбца ER_COLUMNACCESS_DENIED_ERROR %s команда запрещена для пользователя '%s'@'%s' для столбца '%s' в таблице '%s'
1227 Доступ запрещён; нужна привилегия ER_SPECIFIC_ACCESS_DENIED_ERROR Доступ запрещён; вам необходима (хотя бы одна из) привилегий %s для этой операции
1396 Операция CREATE USER завершилась неудачей ER_CANNOT_USER Не удалось выполнить операцию %s для %s
1419 Требуется привилегия SUPER при бинарном логировании ER_BINLOG_CREATE_ROUTINE_NEED_SUPER У вас нет привилегии SUPER, а двоичное журналирование включено (возможно, *стоит* использовать менее безопасную переменную log_bin_trust_function_creators)
1449 Пользователь-определитель не существует ER_NO_SUCH_USER Пользователь, указанный как определитель ('%s'@'%s'), не существует

Синтаксис и операторы

КодЗначение
1064 Ошибка в синтаксисе SQL ER_PARSE_ERROR %s около '%s' в строке %d
1149 Ошибка синтаксиса SQL ER_SYNTAX_ERROR У вас ошибка в синтаксисе SQL; сверьтесь с руководством по вашей версии сервера MySQL, чтобы узнать правильный синтаксис
1052 Столбец неоднозначен ER_NON_UNIQ_ERROR Столбец '%s' в %s неоднозначен
1055 Выражение отсутствует в GROUP BY ER_WRONG_FIELD_WITH_GROUP '%s' отсутствует в GROUP BY
1093 Невозможно указать целевую таблицу для обновления ER_UPDATE_TABLE_USED Вы не можете указывать целевую таблицу '%s' для обновления в предложении FROM
1136 Количество столбцов не соответствует количеству значений ER_WRONG_VALUE_COUNT_ON_ROW Количество столбцов не соответствует количеству значений в строке %ld
1242 Подзапрос возвращает более одной строки ER_SUBQUERY_NO_1_ROW Подзапрос возвращает более одной строки
1248 Каждая производная таблица должна иметь собственный псевдоним ER_DERIVED_MUST_HAVE_ALIAS Каждая производная таблица должна иметь собственный псевдоним
1318 Неправильное количество аргументов ER_SP_WRONG_NO_OF_ARGS Неправильное количество аргументов для %s %s; ожидалось %u, получено %u

Базы данных, таблицы и столбцы

КодЗначение
1049 Неизвестная база данных ER_BAD_DB_ERROR Неизвестная база данных '%s'
1046 База данных не выбрана ER_NO_DB_ERROR База данных не выбрана
1054 Неизвестный столбец в списке полей ER_BAD_FIELD_ERROR Неизвестный столбец '%s' в '%s'
1146 Таблица не существует ER_NO_SUCH_TABLE Таблица '%s.%s' не существует
1050 Таблица уже существует ER_TABLE_EXISTS_ERROR Таблица '%s' уже существует
1051 Неизвестная таблица ER_BAD_TABLE_ERROR Неизвестная таблица '%s'
1060 Повторяющееся имя столбца ER_DUP_FIELDNAME Повторяющееся имя столбца '%s'
1091 Невозможно удалить; проверьте, существует ли столбец/ключ ER_CANT_DROP_FIELD_OR_KEY Невозможно удалить '%s'; проверьте, существует ли столбец/ключ
1305 Функция или процедура не существует ER_SP_DOES_NOT_EXIST %s %s не существует
1442 Триггер не может обновлять собственную таблицу ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG Невозможно обновить таблицу '%s' в хранимой функции/триггере, так как она уже используется оператором, который вызвал эту хранимую функцию/триггер.

Ключи и ограничения

КодЗначение
1062 Повторяющаяся запись для ключа ER_DUP_ENTRY Повторяющаяся запись '%s' для ключа %d
1061 Повторяющееся имя ключа ER_DUP_KEYNAME Повторяющееся имя ключа '%s'
1452 Ошибка внешнего ключа: невозможно добавить дочернюю строку ER_NO_REFERENCED_ROW_2 Невозможно добавить или обновить дочернюю строку: происходит сбой ограничения внешнего ключа%s
1451 Ошибка внешнего ключа: невозможно удалить родительскую строку ER_ROW_IS_REFERENCED_2 Невозможно удалить или обновить родительскую строку: происходит сбой ограничения внешнего ключа%s
1216 Невозможно добавить или обновить дочернюю строку ER_NO_REFERENCED_ROW Невозможно добавить или обновить дочернюю строку: происходит сбой ограничения внешнего ключа
1217 Невозможно удалить или обновить родительскую строку ER_ROW_IS_REFERENCED Невозможно удалить или обновить родительскую строку: происходит сбой ограничения внешнего ключа
1215 Невозможно добавить ограничение внешнего ключа ER_CANNOT_ADD_FOREIGN Невозможно добавить ограничение внешнего ключа
3780 Столбцы внешнего ключа несовместимы ER_FK_INCOMPATIBLE_COLUMNS Ссылающийся столбец '%s' и столбец, на который ссылаются, '%s' в ограничении внешнего ключа '%s' несовместимы.
1822 Отсутствует индекс для ограничения внешнего ключа ER_FK_NO_INDEX_PARENT Не удалось добавить ограничение внешнего ключа. Отсутствует индекс для ограничения '%s' в ссылочной таблице '%s'
1824 Не удалось открыть ссылочную таблицу ER_FK_CANNOT_OPEN_PARENT Не удалось открыть ссылочную таблицу '%s'
1048 Столбец не может быть NULL ER_BAD_NULL_ERROR Столбец '%s' не может быть NULL
3819 Нарушено ограничение CHECK ER_CHECK_CONSTRAINT_VIOLATED Нарушено ограничение CHECK '%s'.
1071 Указанный ключ слишком длинный ER_TOO_LONG_KEY Указанный ключ слишком длинный; максимальная длина ключа %d байт
1075 Допускается только один автоинкрементный столбец, и он должен быть ключом ER_WRONG_AUTO_KEY Некорректное определение таблицы; может быть только один автоинкрементный столбец, и он должен быть определён как ключ
1701 Невозможно очистить таблицу с внешними ключами ER_TRUNCATE_ILLEGAL_FK Невозможно очистить таблицу, на которую ссылается ограничение внешнего ключа (%s)
1586 Повторяющаяся запись для ключа (с именем ключа) ER_DUP_ENTRY_WITH_KEY_NAME Повторяющаяся запись '%s' для ключа '%s'
1826 Повторяющееся имя ограничения внешнего ключа ER_FK_DUP_NAME Повторяющееся имя ограничения внешнего ключа '%s'

Значения данных

КодЗначение
1364 Поле не имеет значения по умолчанию ER_NO_DEFAULT_FOR_FIELD Поле '%s' не имеет значения по умолчанию
1366 Некорректное значение для столбца ER_TRUNCATED_WRONG_VALUE_FOR_FIELD Некорректное значение %s: '%s' для столбца '%s' в строке %ld
1406 Данные слишком длинные для столбца ER_DATA_TOO_LONG Данные слишком длинные для столбца '%s' в строке %ld
1292 Усечено неверное значение ER_TRUNCATED_WRONG_VALUE Усечено неверное значение %s: '%s'
1264 Значение для столбца вне допустимого диапазона ER_WARN_DATA_OUT_OF_RANGE Значение для столбца '%s' в строке %ld вне допустимого диапазона
1265 Данные усечены для столбца WARN_DATA_TRUNCATED Данные усечены для столбца '%s' в строке %ld
1067 Недопустимое значение по умолчанию ER_INVALID_DEFAULT Недопустимое значение по умолчанию для '%s'

Транзакции и блокировки

КодЗначение
1205 Превышено время ожидания блокировки ER_LOCK_WAIT_TIMEOUT Превышено время ожидания блокировки; попробуйте перезапустить транзакцию
1213 Обнаружена взаимная блокировка при попытке получить блокировку ER_LOCK_DEADLOCK Обнаружена взаимная блокировка при попытке получить блокировку; попробуйте перезапустить транзакцию
3572 Не удалось получить блокировку с NOWAIT ER_LOCK_NOWAIT Операция прервана, так как блокировки не могли быть получены немедленно, а NOWAIT установлен.
1206 Блокировки превышают размер таблицы блокировок ER_LOCK_TABLE_FULL Общее количество блокировок превышает размер таблицы блокировок
1792 Запись в транзакции только для чтения ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION Невозможно выполнить оператор в транзакции только для чтения.
3024 Превышено максимальное время выполнения оператора ER_QUERY_TIMEOUT Выполнение запроса было прервано, превышено максимальное время выполнения оператора

Ограничения и настройки сервера

КодЗначение
1040 Слишком много подключений ER_CON_COUNT_ERROR Слишком много подключений
1203 У пользователя больше соединений, чем max_user_connections ER_TOO_MANY_USER_CONNECTIONS У пользователя %s уже больше активных соединений, чем 'max_user_connections'
1153 Получен пакет, превышающий max_allowed_packet ER_NET_PACKET_TOO_LARGE Получен пакет, превышающий 'max_allowed_packet' байт
1175 Режим безопасного обновления заблокировал оператор ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE Вы используете режим безопасного обновления и пытаетесь обновить таблицу без WHERE по ключевому столбцу. %s
1290 Опция сервера предотвращает выполнение этого оператора ER_OPTION_PREVENTS_STATEMENT Сервер MySQL запущен с параметром %s, поэтому он не может выполнить этот оператор
1114 Таблица заполнена ER_RECORD_FILE_FULL Таблица '%s' заполнена
// один клиент, все движки

Более быстрый способ работы с MySQL

SQLly — это нативный SQL-клиент для macOS, Windows и Linux с поддержкой IntelliSense, учитывающей схему базы данных, и защитой от опасных операций.