// Referencia de errores de MySQL

Error de MySQL 1215: no se puede añadir la restricción de clave foránea

MySQL rechazó una definición de FOREIGN KEY: los tipos de columna difieren, el padre no está indexado o el motor de la tabla no soporta claves foráneas.

Número de error
1215
Nombre
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
Categoría
Claves y restricciones
Mensaje de error
Cannot add foreign key constraint

Qué significa

1215 indica que no se pudo crear la clave foránea, pero no el motivo. MySQL 8.0 a menudo reporta en su lugar un error más específico (3780 para columnas incompatibles, 1822 cuando falta un índice en la tabla padre, 1824 cuando falta la tabla padre). Para los detalles, ejecuta SHOW ENGINE INNODB STATUS y lee la LATEST FOREIGN KEY ERROR sección.

Causas comunes

  • Las columnas hija y padre tienen tipos distintos, signo (INT versus INT UNSIGNED), longitud o conjunto de caracteres y colación.
  • Las columnas referenciadas no son una clave primaria o no van al inicio de ningún índice.
  • Una de las tablas usa MyISAM u otro motor sin soporte de claves foráneas.
  • La tabla principal aún no existe cuando se crea la tabla hija.
  • ON DELETE SET NULL en una columna declarada NOT NULL.

Cómo solucionarlo

  1. Lee el motivo detallado.

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. Compara las definiciones de columna en ambos lados y hazlas idénticas.

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. Haz que los tipos de columna coincidan y luego añade la clave.

    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. Convierte las tablas MyISAM a InnoDB.

    ALTER TABLE customers ENGINE = InnoDB;

Errores relacionados

Más errores de claves y restricciones

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.