Erro 1698 MySQL: acesso negado ao root, como resolver
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

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) ouunix_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
GRANTsó 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.