// Referência de erro do MySQL

Erro do MySQL 2059: não foi possível carregar o plugin de autenticação

A conta utiliza um plugin de autenticação que a biblioteca do cliente não possui, tipicamente caching_sha2_password com um cliente ou conector mais antigo.

Número do erro
2059
Nome
CR_AUTH_PLUGIN_CANNOT_LOAD
Categoria
Conexão e cliente
Mensagem de erro
Authentication plugin '%s' cannot be loaded: %s

O que significa

Cada conta MySQL possui um plugin de autenticação. Desde o MySQL 8.0, o padrão é caching_sha2_password. Uma biblioteca cliente que não inclui esse plugin (uma libmysqlclient mais antiga, clientes MariaDB mais antigos, alguns drivers antigos) não consegue concluir o login e reporta o 2059 com o nome do plugin.

Causas comuns

  • Conectando ao MySQL 8.0 ou posterior com um cliente ou conector desenvolvido para MySQL 5.7 ou anterior.
  • Uma biblioteca cliente MariaDB comunicando-se com MySQL 8 sem o plugin instalado.
  • A conta foi criada com um plugin como authentication_ldap_sasl que o cliente não fornece.

Como corrigir

  1. Atualize a biblioteca cliente ou o driver para uma versão que suporte caching_sha2_password. Esta é a correção adequada.

  2. Verifique qual plugin a conta usa.

    SELECT user, host, plugin FROM mysql.user WHERE user = 'app';
  3. Se você não puder atualizar o cliente, mude essa conta para mysql_native_password, onde seu servidor ainda o suporta. Está obsoleto no MySQL 8.0 e desativado por padrão no 8.4.

    ALTER USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY 'password';

Erros relacionados

Mais erros de conexão e do cliente

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.