// Referencia de errores de MySQL

Error de MySQL 1251: el cliente no admite el protocolo de autenticación

El servidor pidió un método de autenticación que el cliente es demasiado antiguo para soportar. Actualiza el cliente o el controlador, o cambia el plugin de la cuenta.

Número de error
1251
Nombre
ER_NOT_SUPPORTED_AUTH_MODE
SQLSTATE
08004
Categoría
Conexión y cliente
Mensaje de error
Client does not support authentication protocol requested by server; consider upgrading MySQL client

Qué significa

Durante el inicio de sesión, el servidor le indica al cliente qué método de autenticación usar. Una biblioteca de cliente anterior a él, como el antiguo mysql de Node.js que habla con MySQL 8 y su caching_sha2_password, no puede continuar y da el error 1251.

Causas comunes

  • Un controlador antiguo o una biblioteca de cliente que se conecta a MySQL 8.0 o posterior.
  • El paquete de Node.js mysql que no soporta caching_sha2_password; mysql2 sí lo hace.
  • Clientes muy antiguos que solo conocen el hashing de contraseñas previo a 4.1.

Cómo solucionarlo

  1. Actualiza el cliente o controlador (para Node.js, cambia a mysql2).

  2. Verifica el plugin de la cuenta.

    SELECT user, host, plugin FROM mysql.user WHERE user = 'app';
  3. Como medida provisional donde el servidor todavía lo permite, cambia la cuenta a mysql_native_password. Está obsoleto y viene desactivado por defecto en MySQL 8.4.

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

Errores relacionados

Más errores de conexión y de cliente

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.