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

Ошибка MySQL 1215: Невозможно добавить ограничение внешнего ключа

MySQL отклонил определение FOREIGN KEY: типы столбцов различаются, родительский столбец не индексирован или движок таблицы не поддерживает внешние ключи.

Номер ошибки
1215
Имя
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
Категория
Ключи и ограничения
Сообщение об ошибке
Cannot add foreign key constraint

Что это значит

1215 говорит, что внешний ключ не может быть создан, но не указывает причину. MySQL 8.0 часто выдает более конкретную ошибку (3780 для несовместимых столбцов, 1822 для отсутствующего родительского индекса, 1824 для отсутствующей родительской таблицы). Для подробностей выполните SHOW ENGINE INNODB STATUS и читайте LATEST FOREIGN KEY ERROR раздел.

Распространённые причины

  • У дочернего и родительского столбцов разные типы и знаковость (INT по сравнению с INT UNSIGNED), длину или набор символов и сопоставление.
  • Ссылаемые столбцы — не первичный ключ или не образуют начало индекса.
  • Одна из таблиц использует MyISAM или другой движок без поддержки внешних ключей.
  • Родительская таблица ещё не существует, когда создаётся дочерняя.
  • ON DELETE SET NULL на столбце, объявленном NOT NULL.

Как исправить

  1. Прочитайте подробное объяснение причины.

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. Сравните определения столбцов с обеих сторон и сделайте их идентичными.

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. Сделайте типы столбцов одинаковыми, затем добавьте ключ.

    ALTER TABLE orders MODIFY customer_id INT UNSIGNED NOT NULL;
    ALTER TABLE orders ADD CONSTRAINT fk_orders_customer
      FOREIGN KEY (customer_id) REFERENCES customers (id);
  4. Преобразуйте таблицы MyISAM в InnoDB.

    ALTER TABLE customers ENGINE = InnoDB;

Связанные ошибки

Больше ошибок ключей и ограничений

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

// меньше ошибок, быстрее исправления

Работа с MySQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.