Base de Conhecimento

Erro 1005 MySQL: Can't create table, como resolver

  • mysql, erro 1005, chave estrangeira, innodb, mariadb
  • Usuários acharam útil: 0

Erro 1005 no MySQL, Can't create table: aprenda a ler o errno, as causas da chave estrangeira mal formada, o nome de restrição repetido e como diagnosticar com SHOW ENGINE INNODB STATUS.

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

Arte da Eleven Host: janela de terminal com o título: Erro 1005 MySQL: Can't create table, como resolver

Capa da Redação Eleven Host para o guia: Erro 1005 MySQL: Can't create table, como resolver Arte: Eleven Host

O erro 1005 MySQL, Can't create table, avisa que o servidor não conseguiu criar a tabela, e o número errno entre parênteses é a pista da causa. Veja como ler a mensagem, a chave estrangeira (errno 150), o errno 121 e como diagnosticar.

Atualizado em 06/11/2026. Os trechos de MySQL partem do manual e da referência de erros da versão 8.4, e os de MariaDB, da documentação do MariaDB; em outra versão, confira o manual da sua. Os exemplos de SQL são montados aqui: confira cada um no seu servidor, de preferência numa cópia dos dados.

Como ler a mensagem do erro 1005

A referência de erros do MySQL registra o 1005 com o símbolo ER_CANT_CREATE_TABLE, o SQLSTATE HY000 e esta mensagem:

Can't create table '%s' (errno: %d - %s)

Segundo o manual, o InnoDB informa esse erro quando não consegue criar a tabela. Com o errno 150, a criação falhou porque a chave estrangeira não foi formada corretamente. Com o errno −1, provavelmente há uma coluna com nome igual ao de uma tabela interna do InnoDB. No MariaDB, a mensagem tem outro formato, com o banco e a tabela entre crases, e o servidor acrescenta depois do número o texto do erro do sistema, como 2 "No such file or directory":

Can't create table `%s`.`%s` (errno: %d)

A mensagem do 1005 é genérica: nem toda ocorrência é de chave estrangeira. Comece pelo errno entre parênteses, porque é ele que separa os casos.

Para ver o texto de um código, o MySQL tem o utilitário perror, que exibe a mensagem de códigos do MySQL ou do sistema operacional. O sentido dos códigos do sistema pode variar entre sistemas. Um exemplo de comando, que você roda no seu servidor para ver a saída:

perror 150 121

Chave estrangeira mal formada: errno 150

O manual lista as condições para criar uma chave estrangeira. Se alguma falha ao recriar uma tabela removida, o resultado é o erro 1005 com o errno 150, e um ALTER TABLE com definição mal formada também devolve o errno 150. As condições são:

  • as tabelas pai e filha usam o mesmo mecanismo de armazenamento e não são temporárias;
  • as colunas correspondentes têm tipos parecidos, e tamanho e sinal de tipos de precisão fixa, como INTEGER e DECIMAL, são iguais; o comprimento de strings não precisa ser igual;
  • em strings não binárias, o charset e a collation são iguais;
  • na tabela filha, existe um índice com as colunas da chave como primeiras, na mesma ordem, e o InnoDB o cria automaticamente se faltar;
  • a coluna da chave não usa prefixo de índice, por isso BLOB e TEXT não entram.

A documentação do MariaDB traz requisitos parecidos: índice na coluna referenciada, tipos parecidos, mesmo sinal e tamanho em inteiros, mesmo charset e collation, mesmo mecanismo, sem tabela temporária nem particionada. Só o InnoDB dá suporte. MySQL e MariaDB não são iguais; para a comparação geral, veja o guia MySQL ou MariaDB.

Um detalhe do manual do MySQL: um REFERENCES escrito direto na definição da coluna é analisado e ignorado, ou seja, não cria chave. Um mecanismo sem suporte, como o MyISAM, também ignora a definição de chave estrangeira. Nesses casos não há erro, mas também não há chave.

Como diagnosticar, na ordem

Recomendamos esta ordem: ler o errno, rodar o SHOW WARNINGS e depois o SHOW ENGINE INNODB STATUS. O SHOW WARNINGS mostra as condições do último comando da sessão, mas não conte com ele para detalhar este erro. Um exemplo: logo depois do erro, rode

SHOW WARNINGS;

SHOW ENGINE INNODB STATUS\G

Segundo o manual, a saída do segundo comando traz a seção LATEST FOREIGN KEY ERROR, com o comando que falhou e dados da restrição e das tabelas. A seção não aparece se esse tipo de erro ainda não ocorreu, e a saída é limitada a 1 MB. Em um CREATE TABLE que falha no InnoDB, a saída inclui o erro de chave estrangeira mais recente.

O SHOW ENGINE INNODB STATUS exige o privilégio PROCESS. Na prática, em hospedagem compartilhada esse acesso pode faltar. Depois, compare as duas tabelas. Um exemplo: com os nomes das tabelas do caso abaixo,

SHOW CREATE TABLE clientes;

SHOW CREATE TABLE pedidos;

Servidor novo está nos seus planos? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Causas comuns na prática

Os três exemplos a seguir aplicam a regra do manual a casos concretos. O erro exato depende da versão: pode aparecer como 1005 com errno 150 ou com outro número. Primeiro, o sinal diferente. Um exemplo: clientes.id é INT UNSIGNED, pedidos.cliente_id é INT, e a segunda tabela falha:

CREATE TABLE clientes (

id INT UNSIGNED NOT NULL PRIMARY KEY

) ENGINE=InnoDB;

CREATE TABLE pedidos (

id INT NOT NULL PRIMARY KEY,

cliente_id INT NOT NULL,

CONSTRAINT fk_pedidos_cliente

FOREIGN KEY (cliente_id) REFERENCES clientes (id)

) ENGINE=InnoDB;

A correção iguala o sinal da coluna filha ao da coluna pai:

CREATE TABLE pedidos (

id INT NOT NULL PRIMARY KEY,

cliente_id INT UNSIGNED NOT NULL,

CONSTRAINT fk_pedidos_cliente

FOREIGN KEY (cliente_id) REFERENCES clientes (id)

) ENGINE=InnoDB;

A diferença de charset ou collation entre as colunas, como utf8mb4_general_ci de um lado e outra collation do outro, cai na mesma regra. Segundo caso, a coluna referenciada sem índice. Um exemplo: produtos.sku não tem índice, e a criação de itens falha:

CREATE TABLE produtos (

id INT NOT NULL PRIMARY KEY,

sku VARCHAR(32) NOT NULL

) ENGINE=InnoDB;

CREATE TABLE itens (

id INT NOT NULL PRIMARY KEY,

sku VARCHAR(32) NOT NULL,

FOREIGN KEY (sku) REFERENCES produtos (sku)

) ENGINE=InnoDB;

A correção cria o índice na tabela pai antes de criar itens:

ALTER TABLE produtos ADD UNIQUE KEY uq_produtos_sku (sku);

Na prática, com a checagem de chaves ligada, a ordem de criação também importa: se a tabela pai não existe ou é criada depois, a criação da filha falha. A referência do MySQL lista o erro 1824, Failed to open the referenced table, para o caso da tabela referenciada que não abre.

Nome de restrição repetido: errno 121

No MySQL, o nome dado em CONSTRAINT precisa ser único no banco. O manual mostra este exemplo de erro por nome repetido, e o MariaDB mostra o 121 com o texto do motor:

ERROR 1005 (HY000): Can't create table 'test.fk1' (errno: 121)

Can't create table `test`.`t1` (errno: 121 "Duplicate key on write or update")

A correção é trocar o nome repetido na segunda tabela. Um exemplo: um nome ainda não usado no banco:

CONSTRAINT fk_itens_produto FOREIGN KEY (sku) REFERENCES produtos (sku)

A regra de nomes de restrição é descrita à parte na documentação do MariaDB; não presuma que seja igual à do MySQL.

Outros números que lembram o 1005

A referência de erros do MySQL lista números próprios para problemas de chave estrangeira. Na prática, um mesmo problema pode aparecer com número diferente, conforme a versão e o cenário. Os principais:

  • 1215, ER_CANNOT_ADD_FOREIGN: Cannot add foreign key constraint. O guia do erro 1215 trata dele.
  • 1822, ER_FK_NO_INDEX_PARENT: falta índice para a restrição na tabela referenciada.
  • 1824, ER_FK_CANNOT_OPEN_PARENT: não foi possível abrir a tabela referenciada.
  • 1826, ER_FK_DUP_NAME: nome de chave estrangeira duplicado.
  • 3780, ER_FK_INCOMPATIBLE_COLUMNS: as colunas referenciadora e referenciada são incompatíveis.

Se a sua mensagem tem outro número, procure por esse número. Quando o erro vier ao apagar linhas, e não ao criar a tabela, o guia do erro 1451 trata da chave estrangeira na remoção.

No MySQL 8.4, referenciar um índice não único ou parcial é uma extensão do InnoDB, hoje obsoleta. Com a variável restrict_fk_on_non_standard_key em ON, que é o padrão, a chave é recusada com o ER_FK_NO_INDEX_PARENT; em OFF, passa com um aviso. Um exemplo de comando, para a sessão:

SET @@session.restrict_fk_on_non_standard_key=OFF;

A própria variável está obsoleta. Em vez de liberá-la, recomendamos criar um índice único na coluna referenciada, como no exemplo acima.

foreign_key_checks: o que ele faz e o que não faz

A variável foreign_key_checks vale ON por padrão, existe no escopo global e de sessão e é dinâmica. Com ela desligada, as restrições são ignoradas, com exceções: recriar uma tabela removida que não atenda às restrições dá erro, um ALTER mal formado dá o errno 150, remover um índice exigido é recusado e criar chave com tipo de coluna incompatível também. A sintaxe é a padrão de variável. Um exemplo:

SET foreign_key_checks = 0;

SET foreign_key_checks = 1;

Desligar a checagem não corrige a definição

Ao religar, o servidor não varre os dados: as linhas inseridas nesse intervalo não são verificadas. No MariaDB, a checagem desligada suspende a verificação dos dados, mas não libera uma mudança de esquema que quebre a restrição. Por isso, não desative a variável e dê o assunto por encerrado: corrija o tipo, o sinal, o charset, o índice ou o nome da restrição.

Com a checagem desligada, o manual diz que também é possível remover o banco e a tabela referenciados por outras. Recomendamos não apagar tabela às cegas: confira antes o que depende dela e trabalhe numa cópia, com backup.

Onde testar as correções

Mudanças de esquema são ensaiadas numa cópia do banco, e não no banco que está em uso.

O banco de dados pode ficar fora do servidor do site? Banco de dados na nuvem, o 11SQL, a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Conhecer o 11SQL

Perguntas frequentes

O erro 1005 é só de chave estrangeira?

Não. Com o errno 150, sim, a chave foi mal formada. Mas a mensagem é genérica: o errno −1, por exemplo, aponta provavelmente para um nome de coluna igual ao de uma tabela interna do InnoDB.

Onde vejo o detalhe do erro de chave estrangeira?

Na seção LATEST FOREIGN KEY ERROR do SHOW ENGINE INNODB STATUS, que exige o privilégio PROCESS.

O que significa o errno 121?

No exemplo do manual do MySQL, é um nome de restrição repetido ao criar a tabela. Troque o nome por um ainda não usado no banco.

Posso desligar o foreign_key_checks para criar a tabela?

Na prática, não corrige uma chave mal formada: com a checagem desligada, o manual diz que um ALTER mal formado ainda dá o errno 150, e as linhas inseridas nesse intervalo não são verificadas ao religar.

Esta resposta lhe foi útil?

Artigos Relacionados