Base de Conhecimento

Erro 1698 MySQL: acesso negado ao root, como resolver

  • mysql, erro 1698, auth_socket, mariadb, ubuntu, access denied
  • Usuários acharam útil: 0

Entenda o erro 1698 do MySQL, a diferença para o 1045, por que o root usa socket no Ubuntu e no Debian, como confirmar a causa e as três soluções.

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

Arte da Eleven Host: janela de terminal com o título: Erro 1698 MySQL: acesso negado ao root, como resolver

Capa da Redação Eleven Host para o guia: Erro 1698 MySQL: acesso negado ao root, como resolver Arte: Eleven Host

O erro 1698 MySQL, Access denied for user 'root'@'localhost', aparece, no caso mais comum, quando o root tenta entrar com senha numa conta que usa autenticação por socket. A saída mais direta é entrar com sudo mysql ou criar um usuário próprio para a aplicação.

Neste guia você vê a mensagem literal do erro, a diferença para o erro 1045, por que o Ubuntu e o Debian deixam o root assim, como confirmar a causa e três soluções em ordem de preferência. As senhas dos exemplos são fictícias: troque SENHA_FORTE por uma senha sua.

O que a mensagem do erro 1698 diz

Na referência de erros do MySQL 8.4, o número 1698 tem o símbolo ER_ACCESS_DENIED_NO_PASSWORD_ERROR, o SQLSTATE 28000 e esta mensagem:

Access denied for user '%s'@'%s'

Os dois %s são o nome do usuário e o host. No seu terminal, a linha aparece com os valores preenchidos. Um exemplo de como ela pode aparecer:

Access denied for user 'root'@'localhost'

A referência traz o número, o símbolo, o SQLSTATE e a mensagem.

O erro 1698 não diz que a senha está errada: o login do root pode estar ligado ao usuário do sistema, e não a uma senha.

Diferença entre o erro 1698 e o erro 1045

Os dois erros têm o mesmo SQLSTATE, 28000, e começam igual. A diferença visível está no fim da mensagem, segundo a mesma referência:

  • 1698, ER_ACCESS_DENIED_NO_PASSWORD_ERROR: Access denied for user '%s'@'%s'
  • 1045, ER_ACCESS_DENIED_ERROR: Access denied for user '%s'@'%s' (using password: %s)

A mensagem do 1045 termina com (using password: YES) ou (using password: NO). A do 1698 não tem esse trecho. Se o seu erro traz o trecho sobre a senha, o caminho é outro: confira usuário, senha e host da conta. Se o seu erro é sobre permissão em um banco específico, o caso é outro, tratado mais abaixo.

Por que o erro 1698 aparece no Ubuntu e no Debian

Na documentação do Ubuntu Server, o pacote mysql-server cria um usuário 'root'@'localhost' para administrar o servidor localmente. Segundo a página, nenhuma senha é exigida, porque esse usuário se autentica com o auth_socket. A autenticação por socket deixa um usuário local do sistema entrar numa conta sem digitar senha, e, por padrão, só o usuário do sistema com o mesmo nome acessa essa conta.

O manual do MySQL 8.4 descreve a regra do plugin auth_socket: ele compara o nome do usuário do sistema operacional com o nome de usuário MySQL que o cliente informou. O plugin só funciona em sistemas que aceitam a opção SO_PEERCRED, como o Linux. E ele recusa a conexão feita por outro protocolo, como o TCP/IP, mesmo para o usuário certo.

No MariaDB o nome do plugin é unix_socket. A documentação diz que ele vem instalado em quase todas as versões e que o 'root'@'localhost' o usa por padrão. Nos pacotes dos repositórios padrão do Debian 9 e posteriores e do Ubuntu 15.10 e posteriores, o root criado pelo mariadb-install-db também usa o unix_socket. Com ele, quem é o root do sistema entra como root@localhost sem senha, desde que o login saia de um processo do root do sistema.

Daí vem o erro: o root do banco está preso ao usuário do sistema, e você tentou entrar com -p, com uma senha ou por um programa que usa TCP. Esse é o caso mais comum. Se o seu problema é de conexão e não de acesso, veja o guia Erro 2003 MySQL: Can't connect to server, como investigar.

Um detalhe sobre o MySQL da Oracle: o plugin padrão das contas novas no MySQL 8.4 é o caching_sha2_password, e não o auth_socket. No MySQL, o root por socket vem do pacote do Ubuntu; no MariaDB, o unix_socket vem dos pacotes do Debian e do Ubuntu.

Como confirmar a causa

O diagnóstico é olhar o plugin de cada conta na tabela mysql.user. O manual do MySQL 8.4 mostra uma consulta com o programa mysql para listar usuário, host e plugin. No Ubuntu, entrando com sudo, um exemplo da consulta é este:

sudo mysql -e "SELECT user, host, plugin FROM mysql.user;"

Procure a linha do root com host localhost. Se a coluna plugin mostrar auth_socket (MySQL) ou unix_socket (MariaDB), o login do root é por socket, e esse é o caso mais comum por trás do erro.

No MariaDB, recomendamos olhar também a definição da conta:

SHOW CREATE USER root@localhost;

Se você usa o MySQL da Oracle, a mesma consulta pode mostrar caching_sha2_password na linha do root. Nesse caso o plugin não é de socket e vale conferir a senha, o usuário e o host.

Solução 1: entrar com sudo mysql

Como a conta do root usa socket, o jeito mais simples de entrar é como root do sistema. A documentação do Ubuntu mostra o comando:

sudo mysql -u root

Dentro do console, você cria bancos e usuários. Essa solução serve para administrar o servidor a partir da sua sessão no terminal. Ela não ajuda uma aplicação, um painel ou uma ferramenta que conecta por TCP, porque o plugin recusa essa conexão.

Para esses casos, siga para a solução 2.

Quer conhecer o banco de dados na nuvem 11SQL? 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Conhecer o 11SQL

Solução 2 (recomendada): um usuário próprio para a aplicação

Recomendamos esta solução: em vez de usar o root, crie um usuário só para a aplicação, com senha, e dê a ele permissão apenas no banco de que ela precisa. O root continua em socket, e a aplicação usa uma conta com acesso limitado. Entre com sudo mysql e rode os comandos. Um exemplo de banco e usuário fictícios, no MySQL:

CREATE DATABASE app_db;

CREATE USER 'app_user'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'SENHA_FORTE';

GRANT ALL PRIVILEGES ON app_db.* TO 'app_user'@'localhost';

A documentação do Ubuntu mostra o mesmo formato de CREATE USER com o plugin caching_sha2_password, que ela chama de plugin do MySQL para criar um usuário autenticado por senha. Por exemplo, o app_db.* limita as permissões ao banco app_db, e não ao servidor inteiro.

No MariaDB, troque a linha do usuário por esta, que não cita o plugin:

CREATE USER 'app_user'@'localhost' IDENTIFIED BY 'SENHA_FORTE';

Depois, configure a aplicação com o usuário app_user, a senha e o banco app_db. Como a conta do exemplo é 'app_user'@'localhost', ela vale para a aplicação no mesmo servidor.

O exemplo usa ALL PRIVILEGES no banco da aplicação por ser o mais simples. Se ela só lê dados, o exemplo da documentação do Ubuntu com GRANT SELECT mostra o princípio: dê só o que a conta usa.

Solução 3: trocar o root para entrar com senha

Esta é a opção para quem precisa mesmo do root com senha, por exemplo para uma ferramenta que só conecta assim. No MySQL, o formato do ALTER USER troca o plugin da conta. Um exemplo, que você roda depois de entrar com sudo mysql:

ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'SENHA_FORTE';

A página do ALTER USER avisa que, ao trocar o plugin de autenticação de uma conta, a senha secundária é descartada. Depois da troca, o root passa a entrar com senha, e a conta passa a aceitar a senha.

No MariaDB, a documentação mostra como manter o acesso por socket e acrescentar a senha na mesma conta, já que se pode usar mais de um plugin por usuário. Um exemplo no formato dela, para o root:

ALTER USER root@localhost IDENTIFIED VIA unix_socket OR mysql_native_password USING PASSWORD('SENHA_FORTE');

Com essa forma, o root continua entrando por socket e também passa a aceitar a senha. No MariaDB o mysql_native_password continua existindo. No MySQL, ele está desativado por padrão no 8.4 e foi removido no 9.0.0, e por isso o exemplo do MySQL acima usa o caching_sha2_password.

Riscos de trocar o root para senha

Trocar o root para senha tira a proteção do socket: quem tiver a senha entra sem precisar ser root do sistema. Além disso, ferramentas da distribuição que usam sudo mysql podem depender do socket. Por isso recomendamos a solução 2. Se mesmo assim trocar o root, use uma senha forte e guarde-a com cuidado.

Erros parecidos de acesso no MySQL

Se a sua mensagem não é a do erro 1698, os guias abaixo cobrem erros vizinhos de permissão e de conexão.

Para um host sem permissão de conectar, veja o Erro 1130 MySQL: host não tem permissão para conectar. Para acesso negado a um banco, veja o Erro 1044 MySQL: Access denied to database, como resolver.

Resumo do erro 1698

  • Mensagem: Access denied for user 'root'@'localhost', sem o trecho (using password).
  • Diagnóstico: sudo mysql -e "SELECT user, host, plugin FROM mysql.user;".
  • Plugin auth_socket (MySQL) ou unix_socket (MariaDB) no root: login por socket.
  • Solução 1: entrar com sudo mysql.
  • Solução 2 (recomendada): usuário da aplicação com senha e GRANT só no banco dela.
  • Solução 3: root com senha, com os riscos explicados acima.

Quer ver os planos de VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Perguntas frequentes

O que significa o erro 1698 no MySQL?

É o erro Access denied for user 'root'@'localhost', com o símbolo ER_ACCESS_DENIED_NO_PASSWORD_ERROR e o SQLSTATE 28000. No caso mais comum, o root está ligado ao socket e a conexão não veio do usuário do sistema.

Qual a diferença entre o erro 1698 e o erro 1045?

A mensagem do 1045 termina com (using password: YES) ou NO, e a do 1698 não tem esse trecho. Os dois usam o SQLSTATE 28000.

Por que o root não aceita senha no Ubuntu?

Porque, segundo a documentação do Ubuntu Server, o pacote mysql-server cria o root com autenticação por auth_socket, que dispensa senha e libera a conta ao usuário do sistema com o mesmo nome.

Como entrar no MySQL como root sem senha?

Use sudo mysql -u root. O sudo faz o comando rodar como o root do sistema, que é o usuário que a conta por socket aceita.

Qual solução você recomenda?

A solução 2: criar um usuário só para a aplicação, com senha e permissão limitada ao banco dela. O root continua protegido pelo socket.

Esta resposta lhe foi útil?

Artigos Relacionados