Base de Conhecimento

Erro 1215 MySQL: Cannot add foreign key, como resolver

  • mysql, erro 1215, foreign key, chave estrangeira, innodb, foreign_key_checks
  • Usuários acharam útil: 0

Entenda o erro 1215 do MySQL, confira tipos, sinal, charset, motor e índice das tabelas, ache a causa com SHOW ENGINE INNODB STATUS e saiba o cuidado ao importar um dump.

Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Erro 1215 MySQL: Cannot add foreign key, como resolver

Capa da Redação Eleven Host para o guia: Erro 1215 MySQL: Cannot add foreign key, como resolver Arte: Eleven Host

O erro 1215 MySQL, "Cannot add foreign key constraint", aparece quando o servidor não consegue criar uma chave estrangeira. A causa está na combinação entre as duas tabelas: tipos diferentes, falta de índice, motores distintos ou charset divergente.

Abaixo estão a mensagem, as condições que o manual do MySQL 8.4 exige para a chave estrangeira funcionar, como descobrir qual delas falhou e o que fazer ao importar um dump.

O que a mensagem do erro 1215 diz

No MySQL 8.4, o erro 1215 tem o símbolo ER_CANNOT_ADD_FOREIGN, o SQLSTATE HY000 e a mensagem "Cannot add foreign key constraint". Ele continua na lista de erros do 8.4. No cliente mysql, um exemplo de como aparece:

ERROR 1215 (HY000): Cannot add foreign key constraint

O MariaDB usa o mesmo código, o mesmo SQLSTATE e o mesmo nome, mas a mensagem dele traz o nome da tabela: "Cannot add foreign key constraint for `%s`".

Na terminologia do manual, a tabela com a chave estrangeira é a tabela filha, e a tabela que ela referencia é a tabela pai.

Em resumo: o erro 1215 acontece na hora de criar a regra, com CREATE TABLE ou ALTER TABLE. Os dados ainda não entraram na conta.

Condições para a chave estrangeira funcionar

O manual lista as regras. Quando uma delas não é cumprida, o servidor recusa a criação. Confira uma a uma:

  • Mesmo motor: as tabelas pai e filha precisam usar o mesmo motor de armazenamento e não podem ser temporárias. Segundo o manual, o InnoDB e o NDB são os que checam chaves estrangeiras.
  • Tipos parecidos: as colunas correspondentes precisam ter tipos de dados parecidos. Em tipos de precisão fixa, como INTEGER e DECIMAL, o tamanho e o sinal precisam ser iguais. Um INT UNSIGNED referenciando um INT não passa.
  • Strings: o comprimento não precisa ser igual. Em colunas de texto, porém, o charset e a collation precisam ser os mesmos.
  • Índice no pai: as colunas referenciadas precisam estar indexadas, como primeiras colunas de um índice, na mesma ordem. No MySQL 8.4, por padrão, a chave referenciada deve ser única ou primária (veja a seção sobre o 8.4 adiante).
  • Índice no filho: o manual diz que o índice é criado automaticamente na tabela filha, se não existir.
  • Privilégio: criar a chave exige o privilégio REFERENCES na tabela pai.

Colunas e tabelas que não aceitam chave estrangeira

Algumas situações são barradas pelo manual, mesmo com tipos e índices corretos:

  • colunas BLOB e TEXT, porque o manual não aceita prefixo de índice em chave estrangeira e esses tipos exigem prefixo;
  • colunas geradas virtuais;
  • tabelas com particionamento definido pelo usuário no InnoDB, tanto a pai quanto a filha;
  • uma coluna que referencia a si mesma (ela pode, porém, referenciar outra coluna da mesma tabela);
  • uma ação SET NULL em coluna declarada como NOT NULL na tabela filha. O MySQL tem uma mensagem própria para isso, a 1830: "Column '%s' cannot be NOT NULL: needed in a foreign key constraint '%s' SET NULL".

Outro ponto: uma tabela que participa de uma chave estrangeira não pode ter o motor trocado. Para mudar o motor, apague as chaves estrangeiras primeiro.

Como descobrir qual condição falhou

A mensagem do 1215 é curta e não aponta a causa. O manual indica o SHOW ENGINE INNODB STATUS para obter informações sobre o último erro de chave estrangeira em tabelas InnoDB. Rode o comando e procure a seção LATEST FOREIGN KEY ERROR:

SHOW ENGINE INNODB STATUS\G

No exemplo do manual, que mostra um INSERT que falhou, a seção aparece com o cabeçalho LATEST FOREIGN KEY ERROR, seguido de data, transação e da definição da constraint, como CONSTRAINT `child_ibfk_1` FOREIGN KEY (`parent_id`) REFERENCES `parent` (`id`).

Em seguida, compare as colunas das duas tabelas. Os comandos abaixo mostram a definição completa de cada uma, com tipo, sinal, charset, collation, motor e índices:

SHOW CREATE TABLE pai;

SHOW CREATE TABLE filho;

Roteiro de conferência

Com as duas definições lado a lado, responda:

  • As duas tabelas usam ENGINE=InnoDB?
  • As colunas ligadas têm o mesmo tipo, o mesmo tamanho e o mesmo sinal (UNSIGNED)?
  • Se forem colunas de texto, o charset e a collation são os mesmos?
  • A coluna referenciada na tabela pai está indexada, como primeira coluna de um índice?
  • Nenhuma delas é TEXT, BLOB ou coluna gerada virtual?

Em que servidor está o seu projeto? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Exemplo de correção: tipos diferentes

Um exemplo montado para ilustrar o caso do sinal diferente. A tabela clientes usa INT UNSIGNED no id, e a tabela pedidos declara a coluna de ligação como INT:

CREATE TABLE clientes (id INT UNSIGNED PRIMARY KEY) ENGINE=InnoDB;

CREATE TABLE pedidos (

id INT UNSIGNED PRIMARY KEY,

cliente_id INT,

FOREIGN KEY (cliente_id) REFERENCES clientes (id)

) ENGINE=InnoDB;

Pela regra do manual, o tamanho e o sinal precisam ser iguais, então esse CREATE TABLE é recusado. O conserto é declarar cliente_id com o mesmo tipo da coluna referenciada:

cliente_id INT UNSIGNED,

Se a tabela filha já existe, ajuste o tipo da coluna com ALTER TABLE ... MODIFY antes de criar a chave. Cuidado com os dados: valores que não existirem na tabela pai podem gerar outro tipo de erro, explicado mais abaixo.

Mensagens mais detalhadas no MySQL 8

Além do 1215, a lista de erros do MySQL 8.4 traz mensagens de chave estrangeira que dizem mais. Elas nomeiam a tabela, a coluna ou a constraint envolvida. Alguns exemplos, todos com SQLSTATE HY000:

  • 1822: "Failed to add the foreign key constraint. Missing index for constraint '%s' in the referenced table '%s'";
  • 3780: "Referencing column '%s' and referenced column '%s' in foreign key constraint '%s' are incompatible.";
  • 3734: "Failed to add the foreign key constraint. Missing column '%s' for constraint '%s' in the referenced table '%s'";
  • 6125: "Failed to add the foreign key constraint. Missing unique key for constraint '%s' in the referenced table '%s'".

O texto de cada mensagem já indica a causa: a 3780 fala de colunas incompatíveis, a 1822 e a 6125 falam de índice ou chave única ausente na tabela pai. Se você receber uma delas no lugar do 1215, siga a pista da própria mensagem e use as mesmas conferências deste guia.

O que mudou no MySQL 8.4: chave que não é única

Nas notas da versão 8.4.0, o manual diz que usar chaves não únicas ou parciais como chave estrangeira está obsoleto. A partir dessa versão, é preciso habilitar isso de forma explícita. A variável restrict_fk_on_non_standard_key vem ligada (ON) por padrão, e uma chave estrangeira apontando para chave não padrão em CREATE TABLE ou ALTER TABLE é rejeitada.

O manual descreve como permitir esse uso: ajustar a variável para OFF ou iniciar o servidor com a opção --skip-restrict-fk-on-non-standard-key. Mesmo assim, ainda precisa existir um índice na tabela referenciada, com as colunas referenciadas como primeiras colunas, na mesma ordem. Atualizações do MySQL 8.0 para o 8.4 são aceitas mesmo que o banco antigo tenha chaves estrangeiras apontando para chaves não únicas ou parciais.

Na prática, um dump vindo de um servidor mais antigo, com chave estrangeira apontando para coluna sem UNIQUE nem PRIMARY KEY, pode falhar ao ser carregado num servidor 8.4. O manual trata a chave não única como obsoleta; o caminho padrão é referenciar uma chave única ou primária.

foreign_key_checks e a importação de dump

A checagem de chaves estrangeiras é controlada pela variável foreign_key_checks, ligada por padrão, dinâmica e com escopo global e de sessão. Segundo o manual, o mysqldump inclui no arquivo uma instrução que desliga essa variável. Isso permite importar as tabelas mesmo que o arquivo as traga fora da ordem exigida pelas chaves, e também acelera a importação. Para fazer a mesma coisa à mão, um exemplo de comandos:

SET foreign_key_checks = 0;

-- importar o arquivo aqui

SET foreign_key_checks = 1;

Desligar a variável não resolve o erro 1215 por si só. O manual lista casos em que um erro continua mesmo com a checagem desligada:

  • recriar uma tabela apagada com definição que não respeita as chaves que a referenciam. A tabela precisa ter os nomes e tipos de coluna corretos e os índices nas chaves referenciadas;
  • alterar uma tabela com definição de chave estrangeira mal formada (errno: 150);
  • apagar um índice exigido por uma chave estrangeira;
  • criar uma chave estrangeira em que uma coluna referencia uma coluna de tipo diferente.

Ou seja: tipo incompatível e índice ausente continuam sendo barrados. E há um risco que o manual deixa claro: ligar o foreign_key_checks de novo não dispara uma varredura dos dados. Linhas inseridas enquanto a variável esteve desligada não são conferidas quando ela volta a ser ligada. Por isso, desligar para importar exige cuidado com a consistência dos dados.

Se o dump falhar logo no começo por falta de banco selecionado, o problema é outro, tratado no guia Erro 1046 MySQL: No database selected, como resolver.

Erro 1215 ou erros 1451 e 1452

Os três falam de chave estrangeira, mas em momentos diferentes. O 1215 acontece ao criar a regra. Já o 1451 e o 1452 acontecem quando os dados violam uma regra que já existe, ambos com SQLSTATE 23000:

  • 1451: "Cannot delete or update a parent row: a foreign key constraint fails";
  • 1452: "Cannot add or update a child row: a foreign key constraint fails".

O primeiro surge ao apagar ou alterar um registro pai que ainda é referenciado, e o segundo ao inserir ou alterar um registro filho sem pai correspondente. Para o caso de apagar, veja o guia Erro 1451 MySQL: foreign key ao apagar, como resolver. O manual também diz que, sem privilégio de tabela em todas as tabelas pai, o servidor mostra versões mais genéricas dessas mensagens, os erros 1216 e 1217.

Resumo para resolver

Rode SHOW ENGINE INNODB STATUS e leia a seção LATEST FOREIGN KEY ERROR. Compare as tabelas com SHOW CREATE TABLE. Confira o motor, o tipo, o tamanho, o sinal, o charset e a collation e o índice da coluna referenciada no pai. Se o problema aparecer só na importação, lembre que o foreign_key_checks desligado não corrige tipo incompatível nem índice ausente.

Como você organiza os bancos de dados do projeto? O 11SQL é um banco de dados na nuvem. 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Ver o 11SQL

Perguntas frequentes

O que significa o erro 1215 no MySQL?

Significa "Cannot add foreign key constraint": o servidor não conseguiu criar a chave estrangeira. O SQLSTATE é HY000.

Por que o erro 1215 acontece?

Entre as causas do manual estão motores diferentes, tipos com tamanho ou sinal diferentes, charset ou collation diferentes em colunas de texto, ausência de índice na tabela referenciada e SET NULL em coluna NOT NULL.

Como descobrir a causa exata do erro 1215?

Use o SHOW ENGINE INNODB STATUS e procure a seção LATEST FOREIGN KEY ERROR. Depois compare as duas tabelas com SHOW CREATE TABLE.

Desligar o foreign_key_checks resolve o erro 1215?

Não por si só. Tipo incompatível e índice ausente continuam sendo barrados, e os dados inseridos com a checagem desligada não são conferidos quando ela volta a ser ligada.

Qual a diferença entre o erro 1215 e o erro 1452?

O 1215 acontece ao criar a chave estrangeira. O 1452 acontece ao inserir ou alterar uma linha filha que não tem pai correspondente.

Esta resposta lhe foi útil?

Artigos Relacionados