// Referência de erro do MySQL

Erro do MySQL 1215: Não é possível adicionar a restrição de chave estrangeira

O MySQL rejeitou uma definição de FOREIGN KEY: os tipos das colunas são diferentes, a tabela pai não está indexada ou o mecanismo da tabela não suporta chaves estrangeiras.

Número do erro
1215
Nome
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
Categoria
Chaves e restrições
Mensagem de erro
Cannot add foreign key constraint

O que significa

O 1215 diz que a chave estrangeira não pôde ser criada, mas não o porquê. O MySQL 8.0 costuma relatar um erro mais específico (3780 para colunas incompatíveis, 1822 para índice do pai ausente, 1824 para tabela pai ausente). Para os detalhes, execute SHOW ENGINE INNODB STATUS e leia o LATEST FOREIGN KEY ERROR seção.

Causas comuns

  • As colunas filho e pai têm tipos e sinalidades diferentes (INT versus INT UNSIGNED), comprimento ou conjunto de caracteres e collation.
  • As colunas referenciadas não são uma chave primária nem iniciam um índice.
  • Uma das tabelas usa MyISAM ou outro mecanismo sem suporte a chave estrangeira.
  • A tabela pai ainda não existe quando a tabela filha é criada.
  • ON DELETE SET NULL em uma coluna declarada NOT NULL.

Como corrigir

  1. Leia o motivo detalhado.

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. Compare as definições de coluna em ambos os lados e torne-as idênticas.

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. Faça os tipos das colunas corresponderem e depois adicione a chave.

    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. Converta tabelas MyISAM para InnoDB.

    ALTER TABLE customers ENGINE = InnoDB;

Erros relacionados

Mais erros de chaves e restrições

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.