// Referencia de errores de MySQL

Error de MySQL 2026: fallo de conexión SSL

Falló el handshake TLS entre el cliente y el servidor MySQL: un certificado en el que el cliente no confía, versiones de TLS que no coinciden o SSL requerido pero deshabilitado.

Número de error
2026
Nombre
CR_SSL_CONNECTION_ERROR
Categoría
Conexión y cliente
Mensaje de error
SSL connection error: %s

Qué significa

El cliente y el servidor no pudieron establecer una conexión cifrada. El texto después de SSL connection error: es el motivo que da la biblioteca TLS, por ejemplo una falla al verificar el certificado o que no hay una versión de protocolo en común, y es la parte que hay que leer.

Causas comunes

  • El cliente verifica el certificado del servidor (--ssl-mode=VERIFY_CA o VERIFY_IDENTITY) y el certificado está autofirmado o el nombre del host no coincide.
  • El cliente está configurado para requerir TLS y el servidor lo tiene deshabilitado.
  • Un cliente o servidor antiguo solo admite versiones de TLS que la otra parte ha desactivado.
  • Rutas o permisos incorrectos para los archivos de la CA, certificado o clave.

Cómo solucionarlo

  1. Comprueba qué ofrece el servidor.

    SHOW VARIABLES LIKE '%ssl%';
    SHOW VARIABLES LIKE 'tls_version';
  2. Dale al cliente el certificado de la CA que firmó el certificado del servidor, por ejemplo mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p.

  3. Si ambos lados son antiguos, actualiza la biblioteca del cliente en lugar de volver a habilitar versiones antiguas de TLS en el servidor.

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.