// Referência de erro do MySQL

Erro do MySQL 2026: erro de conexão SSL

O handshake TLS entre o cliente e o servidor MySQL falhou: um certificado em que o cliente não confia, versões TLS incompatíveis, ou SSL exigido mas desabilitado.

Número do erro
2026
Nome
CR_SSL_CONNECTION_ERROR
Categoria
Conexão e cliente
Mensagem de erro
SSL connection error: %s

O que significa

O cliente e o servidor não conseguiram estabelecer uma conexão criptografada. O texto após SSL connection error: é a razão apontada pela biblioteca TLS, por exemplo, uma falha na verificação do certificado ou nenhuma versão de protocolo em comum, e é a parte que vale ler.

Causas comuns

  • O cliente verifica o certificado do servidor (--ssl-mode=VERIFY_CA ou VERIFY_IDENTITY) e o certificado é autoassinado ou o nome do host não corresponde.
  • O cliente está configurado para exigir TLS e o servidor está com TLS desabilitado.
  • Um cliente ou servidor antigo suporta apenas versões TLS que o outro lado desativou.
  • Caminhos errados ou permissões incorretas para os arquivos de CA, certificado ou chave.

Como corrigir

  1. Verifique o que o servidor oferece.

    SHOW VARIABLES LIKE '%ssl%';
    SHOW VARIABLES LIKE 'tls_version';
  2. Forneça ao cliente o certificado da CA que assinou o certificado do servidor, por exemplo mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p.

  3. Se ambos os lados forem antigos, atualize a biblioteca do cliente em vez de reativar versões antigas de TLS no servidor.

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.