// Referência de erro do MySQL

Erro do MySQL 1452: falha na chave estrangeira: não é possível adicionar a linha filha

Um INSERT ou UPDATE define uma coluna de chave estrangeira como um valor sem linha correspondente na tabela pai. Insira o pai primeiro ou corrija o valor.

Número do erro
1452
Nome
ER_NO_REFERENCED_ROW_2
SQLSTATE
23000
Categoria
Chaves e restrições
Mensagem de erro
Cannot add or update a child row: a foreign key constraint fails%s

O que significa

Uma chave estrangeira diz que todo valor na coluna filha precisa existir na coluna referenciada da tabela pai. 1452 significa que a linha que você está escrevendo aponta para um pai que não existe. A mensagem termina com a definição completa da restrição, que nomeia as duas tabelas e as colunas.

Causas comuns

  • Inserindo linhas filho antes das linhas pai, por exemplo ao carregar order_lines antes orders.
  • Um erro de digitação ou id desatualizado na coluna de chave estrangeira.
  • Adicionando uma chave estrangeira a uma tabela cujos dados existentes já possuem registros órfãos (o ALTER TABLE falha com 1452).
  • Colunas que parecem iguais, mas diferem na collation ou em espaços finais.

Como corrigir

  1. Verifique se o pai existe.

    SELECT id FROM orders WHERE id = 1001;
  2. Insira primeiro o pai ou carregue as tabelas na ordem de dependência.

  3. Antes de adicionar uma chave estrangeira, encontre linhas órfãs.

    SELECT l.*
    FROM order_lines l
    LEFT JOIN orders o ON o.id = l.order_id
    WHERE o.id IS NULL;
  4. Para uma carga em massa onde a ordem não pode ser controlada, desative as verificações para a sessão e depois verifique se não há órfãos antes de ativá-las novamente. Linhas carregadas enquanto as verificações estão desativadas não são verificadas novamente depois.

    SET foreign_key_checks = 0;
    -- load data
    SET foreign_key_checks = 1;

Reproduza com segurança

CREATE TABLE p (id INT PRIMARY KEY);
CREATE TABLE c (id INT PRIMARY KEY, p_id INT, FOREIGN KEY (p_id) REFERENCES p (id));
INSERT INTO c VALUES (1, 99);  -- ERROR 1452 (23000)
DROP TABLE c, p;

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.