Base de Conhecimento

Erro 1396 MySQL: CREATE USER failed, como investigar

  • mysql, erro 1396, create user, drop user, mariadb
  • Usuários acharam útil: 0

Erro 1396 no MySQL, Operation CREATE USER failed: confira usuário e host, entenda IF NOT EXISTS e IF EXISTS e saiba por que FLUSH PRIVILEGES não resolve.

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 1396 MySQL: CREATE USER failed, como investigar

Capa da Redação Eleven Host para o guia: Erro 1396 MySQL: CREATE USER failed, como investigar Arte: Eleven Host

O erro 1396 MySQL, Operation CREATE USER failed, aparece quando um comando de conta, como CREATE USER ou DROP USER, não consegue ser concluído para uma conta. Veja o que a mensagem diz, como conferir as contas reais e o caminho de cada comando.

O que a mensagem diz

A referência de erros do MySQL registra o erro 1396 com o símbolo ER_CANNOT_USER, o SQLSTATE HY000 e a mensagem abaixo. É a mesma referência nas versões 8.4 e 9.7:

Error number: 1396; Symbol: ER_CANNOT_USER; SQLSTATE: HY000

Message: Operation %s failed for %s

Os dois %s são preenchidos com o nome da operação e com a conta, o que se deduz do formato da mensagem. A referência não explica as causas: traz só número, símbolo, SQLSTATE e texto. A saída aparece assim na documentação do MariaDB:

ERROR 1396 (HY000):

Operation CREATE USER failed for 'u1'@'%','u2'@'%'

Os detalhes deste texto vêm dos manuais do MySQL 8.4 e 9.7. Em outras versões, e no MariaDB, confira o manual da versão instalada no seu servidor, porque o comportamento pode mudar.

Não apague linhas de mysql.user para fazer o erro sumir. O manual desaconselha mexer direto nas tabelas de permissões e diz que isso é feito por sua conta e risco.

Situações prováveis

O manual do MySQL não lista as causas desse número nem cita o 1396 ao tratar desses comandos. Só a documentação do MariaDB liga o 1396 ao CREATE USER de conta que já existe e ao DROP USER de conta que não existe. Pelo que o manual do MySQL diz de cada comando, as situações prováveis são estas, que não testamos:

  • CREATE USER de uma conta que já existe. Por padrão, o manual diz que ocorre erro ao criar um usuário que já existe.
  • DROP USER ou ALTER USER de uma conta que não existe. Nos dois casos, o manual diz que há erro por padrão.
  • Host diferente do que você imagina. Sem host, o comando usa '%', e DROP USER 'app' não atinge 'app'@'localhost'.
  • Aspas no lugar errado, que mudam o nome da conta.
  • Uma lista de contas com uma só problemática, caso em que o MySQL desfaz o comando inteiro.
  • Edição manual da tabela mysql.user, como um DELETE direto seguido da tentativa de recriar a conta. Esta é só uma hipótese: o manual apenas desaconselha a edição direta e diz que ela não vale até as tabelas serem recarregadas.

Quando a mensagem aparece, o primeiro passo é descobrir qual dessas situações é a sua. Para isso, olhe as contas que existem de verdade.

Conferir as contas reais

A tabela user, do esquema mysql, tem uma linha por conta, e as colunas User e Host guardam o nome do usuário e o do host. Um exemplo de consulta, para conferir no seu servidor, com um usuário chamado app:

SELECT User, Host FROM mysql.user WHERE User = 'app';

Para ver os privilégios de uma conta, o manual usa o SHOW GRANTS, como neste exemplo:

SHOW GRANTS FOR 'admin'@'localhost';

Para a verificação de acesso, o manual diz que o User diferencia maiúsculas de minúsculas e que o Host não diferencia. Compare, então, o que apareceu na consulta com o nome exato que você usou no comando que falhou.

Usuário e host: duas contas diferentes

No MySQL, o nome da conta tem duas partes. O manual cria 'finley'@'localhost' e 'finley'@'%.example.com' e diz que são duas contas com o mesmo nome de usuário. Por isso, 'app'@'localhost' e 'app'@'%' não são a mesma conta, e um comando pode funcionar para uma e falhar para a outra.

Um nome só com o usuário equivale a 'usuário'@'%'. Se você escreve DROP USER 'app' achando que apaga a conta local, o comando procura a conta 'app'@'%'. Se ela não existe, o erro aparece. Na conexão, o servidor ordena as linhas colocando primeiro os hosts mais específicos e usa a primeira que combina, e o '%' é o menos específico. Se o erro de acesso aparece no lugar do 1396, o erro 1130, host sem permissão para conectar trata dessa parte.

As aspas também contam. O manual pede que usuário e host sejam citados separadamente: escreva 'me'@'localhost', e não 'me@localhost'. A segunda forma equivale a 'me@localhost'@'%', comportamento que o manual já considera obsoleto. Quem digita o nome entre um único par de aspas está se referindo, sem querer, a outra conta.

Bancos de dados na Eleven Host

A Eleven Host também oferece banco de dados na nuvem, o 11SQL.

Um banco de dados na nuvem entra nos seus planos? 11SQL, banco de dados na nuvem, a partir de R$ 9,90/mês no 11SQL Mini; confira na loja o que cada plano inclui. Ver o 11SQL

O caminho de cada comando

CREATE USER

Por padrão, dá erro se a conta já existe. Com IF NOT EXISTS, o comando gera um aviso para cada conta que já existe, em vez de um erro. Para usar o CREATE USER, você precisa do privilégio global CREATE USER ou do privilégio INSERT no esquema mysql, segundo o manual 8.4.

DROP USER

Por padrão, dá erro se a conta não existe. Com IF EXISTS, o comando gera um aviso para cada conta inexistente, em vez de um erro.

ALTER USER

Também dá erro, por padrão, se a conta não existe, e o IF EXISTS troca o erro por aviso. Em muitos casos, o comando pede o privilégio global CREATE USER ou o privilégio UPDATE no esquema mysql.

RENAME USER

O manual diz que ocorre erro para contas antigas que não existem e para contas novas que já existem.

O IF NOT EXISTS e o IF EXISTS só trocam o erro por aviso. O manual só fala em aviso no lugar de erro e não diz que a conta existente é alterada; por isso entendemos que ela continua como está. Recomendamos conferir a conta depois. Um exemplo de roteiro, para conferir no seu servidor:

-- 1. Ver as contas reais desse usuário

SELECT User, Host FROM mysql.user WHERE User = 'app';

-- 2. Criar só se não existir (avisa em vez de dar erro)

CREATE USER IF NOT EXISTS 'app'@'localhost' IDENTIFIED BY '<senha>';

-- 3. Remover só se existir, com o host certo

DROP USER IF EXISTS 'app'@'localhost';

-- 4. Ler o aviso, se houver

SHOW WARNINGS;

Se o que aparece é negação de acesso, e não o 1396, o problema é outro. Os erros de acesso negado têm outros números, como o 1045, com a mensagem Access denied for user, e o erro 1044, Access denied to database. O 1133 trata de linha não encontrada na tabela de usuários, e o 1410 trata do uso de GRANT para criar usuário. Não encontramos qual erro sai quando falta privilégio para o CREATE USER, então não afirmamos um número.

Lista de contas: o MySQL desfaz tudo

Quando o comando traz várias contas, o manual do MySQL diz que o CREATE USER e o DROP USER têm sucesso para todas ou são desfeitos, sem efeito algum, se ocorrer erro. Ou seja, uma conta problemática no meio da lista faz o comando inteiro falhar, e nenhuma conta é criada ou apagada. Se o erro citar uma só conta, confira se as outras da lista estão certas e rode de novo.

No MariaDB é diferente

A documentação do MariaDB liga o número 1396 às duas situações: no CREATE USER, a conta existente causa o erro; no DROP USER, o erro sai quando alguma conta não existe. Numa lista de contas, as sem problema são criadas ou apagadas e sai um erro para as demais. Para o DROP USER, a documentação diz que ele ainda apaga as contas que não dão erro. Se você alterna entre os dois servidores, o comparativo entre MySQL e MariaDB mostra outras diferenças.

O MariaDB tem ainda o CREATE OR REPLACE USER, um atalho que apaga a conta, se ela existir, e a cria de novo. Ele não aparece nos manuais do MySQL citados aqui. Como apaga a conta antiga, confira os privilégios antes de usá-lo. Na documentação do MariaDB, há também o caso de restos de uma conta anônima (''@'%') na tabela mysql.db que podem bloquear a criação da conta com o 1396. A página do MariaDB traz a correção.

Cuidados ao apagar uma conta

Antes de rodar o DROP USER, o manual traz avisos que merecem atenção. Primeiro, o comando não fecha as sessões abertas da conta: se ela tem uma sessão aberta, a remoção só vale quando essa sessão termina, e o login seguinte falha. Segundo, o comando falha com erro se a conta a apagar for o DEFINER de algum objeto armazenado. Terceiro, ele não apaga nem invalida os bancos e objetos que o usuário criou.

Guarde os privilégios antes

Apagar a conta e criá-la de novo pode fazer você perder os privilégios dela. Recomendamos rodar o SHOW GRANTS da conta e guardar o resultado antes do DROP USER, para refazer os GRANT depois, e conferir se o DEFINER de algum objeto aponta para ela.

FLUSH PRIVILEGES não é a solução

Há quem sugira rodar FLUSH PRIVILEGES. Segundo o manual 8.4, recarregar as tabelas de permissões só é necessário quando você altera as tabelas diretamente, e não para comandos de conta como GRANT e REVOKE, que valem na hora. O servidor percebe as mudanças feitas por esses comandos e recarrega as tabelas sozinho.

Na versão 9.7, o manual avisa que o FLUSH PRIVILEGES é obsoleto, gera um aviso de obsolescência e deve ser removido numa versão futura. O mesmo manual diz que manipular as tabelas de permissões diretamente não é recomendado e é uma funcionalidade obsoleta. Por isso, não prometemos que o FLUSH PRIVILEGES resolva o 1396. No máximo, ele entra se você mexeu nas tabelas à mão, e a recomendação é parar de mexer nelas à mão.

Teste fora da produção

Para testar contas, permissões e comandos de usuário, recomendamos um banco que não seja o de produção.

Um servidor virtual entra nas suas contas? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Perguntas frequentes

O erro 1396 acontece só no CREATE USER?

Não necessariamente. A mensagem tem o nome da operação como parâmetro: a documentação do MariaDB mostra o 1396 em CREATE USER e DROP USER, e o formato permite o mesmo para outras operações, como ALTER USER. O erro 1698, acesso negado ao root é outro caso, de acesso.

O IF NOT EXISTS corrige o erro?

Ele troca o erro por um aviso. Entendemos que a conta que já existe não é alterada, mas confira a senha e os privilégios dela.

Devo rodar o FLUSH PRIVILEGES?

Para comandos de conta, o manual diz que não é necessário, e na versão 9.7 o comando é obsoleto.

Posso apagar a linha em mysql.user?

Não recomendamos. O manual desaconselha a edição direta das tabelas de permissões.

Esta resposta lhe foi útil?

Artigos Relacionados