MySQL Error Message: Plugin caching_sha2_password could not be loaded: The specified module could not be found. Library path is ‘caching_sha2_password.dll’
ERROR: Failed to connect to database.
indica que o cliente MySQL (ou a extensão que você está usando para conectar ao banco) está tentando usar o plugin de autenticação caching_sha2_password, mas não consegue carregar a biblioteca (DLL) necessária no seu ambiente.
Por que isso acontece?
- A partir do MySQL 8.0, o método padrão de autenticação é o caching_sha2_password.
- Alguns clientes, drivers ou extensões PHP (ex:mysqli, pdo_mysql) antigos ou mal configurados não suportam esse método e precisam do plugin para se autenticar.
- O erro aponta que o arquivo caching_sha2_password.dll não está disponível ou acessível na pasta de plugins do MySQL cliente ou do PHP.
Como corrigir?
Opção 1 — Mudar o plugin de autenticação do usuário MySQL para mysql_native_password.
No servidor MySQL, rode:
ALTER USER ‘seu_usuario’@’localhost’ IDENTIFIED WITH mysql_native_password BY ‘sua_senha’;
FLUSH PRIVILEGES;
Isso faz o usuário usar o método antigo, mais compatível.
Opção 2 — Atualizar seu cliente/driver MySQL
- Se estiver usando PHP, atualize para a versão mais recente do PHP e das extensões mysqli e pdo_mysql.
- Se estiver usando outro cliente, atualize para versão que suporte caching_sha2_password.
Opção 3 — Instalar o plugin no seu sistema
- Baixe a DLL caching_sha2_password.dll compatível com seu sistema e coloque no diretório correto (ext do PHP, ou plugins do MySQL).
- Configure o my.ini/my.cnf para apontar para o diretório correto dos plugins.
Resumo rápido para maioria dos casos:
Se você tem acesso ao banco, rode o comando de troca para mysql_native_password. Isso resolve a conexão de imediato e evita a DLL:
ALTER USER ‘seu_usuario’@’localhost’ IDENTIFIED WITH mysql_native_password BY ‘sua_senha’;
FLUSH PRIVILEGES;