Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Como solucionar falhas de conexão com uma instância ApsaraDB RDS?

Última atualização: Oct 10, 2026

Falhas de conexão com uma instância ApsaraDB RDS geralmente ocorrem por um de quatro motivos. Identifique o cenário que corresponde à sua situação para agilizar o diagnóstico:

Causa

Acesse

Instância bloqueada, reiniciando ou com endpoint configurado incorretamente

Step 1: Check instance status and connection info

Endereço IP do cliente não permitido pela lista de permissões

Step 2: Check whitelist configuration

Excesso de conexões ou alto uso de recursos na instância

Step 3: Check instance performance

Comandos de rede como telnet ou ping com tempo limite esgotado ou falha

Step 4: Check the network and client

| Instância ECS sem acesso ao RDS pela rede interna | ECS to RDS over internal network

|

Connecting to <public endpoint>...Could not open connection to the host, on port 3306: Connect failed

Etapa 1: Verificar o status da instância e as informações de conexão

  1. Faça login no console do ApsaraDB RDS. Na página Instances, verifique o status da sua instância RDS. Caso a instância esteja bloqueada, resolva esse problema primeiro. Para mais detalhes, consulte What do I do if my ApsaraDB RDS for MySQL instance is automatically locked due to exhausted storage capacity?. Uma instância bloqueada não permite operações de leitura ou escrita. Reinicie a instância apenas após confirmar que essa ação não afetará suas cargas de trabalho. Proceda com cautela.

  2. No código da sua aplicação ou no cliente de banco de dados, verifique se os parâmetros de conexão estão corretos — especificamente, se o endpoint interno ou público corresponde ao exibido no console. Para mais detalhes, consulte Connect to an ApsaraDB RDS instance.

Etapa 2: Verificar a configuração da lista de permissões

Certifique-se de que o endereço IP da máquina cliente foi adicionado a uma lista de permissões de endereços IP da instância RDS.

Para isolar rapidamente um problema de lista de permissões, adicione temporariamente 0.0.0.0/0 à lista. Se a conexão for bem-sucedida após essa alteração, o endereço IP adicionado anteriormente está incorreto. Remova 0.0.0.0/0 e adicione o endereço IP correto.

Aviso

0.0.0.0/0 permite que todos os dispositivos acessem a instância RDS. Remova essa entrada imediatamente após o teste.

Para obter instruções sobre como configurar a lista de permissões, consulte Step 2: Connect to an ApsaraDB RDS for MySQL instance.

Erros comuns na lista de permissões:

  • A lista de permissões padrão contém apenas 127.0.0.1, o que bloqueia todas as conexões externas. Adicione o endereço IP do seu cliente a um grupo de lista de permissões.

  • 0.0.0.0 é uma entrada inválida. O formato correto é 0.0.0.0/0.

Modo de lista de permissões aprimorada:

Se o modo de lista de permissões aprimorada estiver ativado (consulte Change the network isolation mode of an ApsaraDB RDS instance to the enhanced whitelist mode), adicione os endereços IP ao tipo correto de lista de permissões:

Tipo de endpoint

Endereço IP a ser adicionado

Tipo de lista de permissões

Endpoint interno da VPC

Endereço IP privado da instância ECS

Lista de permissões tipo VPC

Endpoint interno de rede clássica

Endereço IP privado da instância ECS

Lista de permissões tipo rede clássica

Endpoint público

Endereço IP público do cliente

Lista de permissões tipo rede clássica

A lista de permissões tipo VPC não se aplica a conexões via Internet.

Se o seu endereço IP público não for o IP de saída real:

O endereço IP exibido por ferramentas de consulta ou sites pode diferir do IP de saída real da sua máquina por dois motivos: endereços IP públicos mudam dinamicamente e as ferramentas de consulta às vezes retornam resultados imprecisos. Consulte os tópicos a seguir para obter orientações específicas por mecanismo:

Etapa 3: Verificar o desempenho da instância

Analise as métricas de monitoramento de desempenho da instância RDS para determinar se o esgotamento de recursos está causando falhas de conexão.

Verifique o número de conexões:

O esgotamento de conexões ocorre frequentemente devido a um grande número de conexões ociosas ou ativas que não foram fechadas. Para diagnosticar:

  1. Localize o número máximo de conexões suportado pelo tipo da sua instância em Primary ApsaraDB RDS instance types e compare-o com a contagem atual de conexões.

  2. Revise o código da sua aplicação para confirmar se as conexões são fechadas após o uso. Conexões não fechadas em tempo hábil consomem recursos e podem levar ao esgotamento das conexões. Para soluções, consulte What do I do if the number of connections to an ApsaraDB RDS for MySQL instance reaches the upper limit? ou What do I do if excessive connections are established to an ApsaraDB RDS for PostgreSQL instance?.

Atualize a instância se os recursos forem consistentemente insuficientes:

Caso sua demanda tenha ultrapassado a capacidade atual da instância, atualize a configuração dela. Durante a atualização, pode ocorrer uma desconexão transitória com duração aproximada de 30 segundos. Configure sua aplicação para reconectar automaticamente e manter a continuidade do service. Para mais informações, consulte Limits.

Verifique tráfego de rede elevado ou consultas lentas:

Se o uso do tráfego de rede estiver alto, visualize slow query logs e otimize instruções SQL lentas.

Para problemas relacionados a utilização de CPU, uso de memória, uso de disco ou IOPS, consulte What do I do if the CPU utilization, memory usage, disk usage, or IOPS of an ApsaraDB RDS instance is high?.

Etapa 4: Verificar a rede e o cliente

Teste a conectividade de rede:

Execute ping ou telnet para verificar se o endpoint do RDS está acessível a partir da sua máquina. Substitua &lt;public endpoint&gt; pelo endpoint real da sua instância RDS:

Connecting to <public endpoint>...Could not open connection to the host, on port 3306: Connect failed

Se a conexão for bem-sucedida, o comando não produzirá saída e ficará aguardando (pressione Ctrl+C para sair). Se a conexão falhar, você verá um erro semelhante a:

Connecting to <public endpoint>...Could not open connection to the host, on port 3306: Connect failed

Caso a conexão falhe ou atinja o tempo limite, o firewall local pode estar bloqueando o tráfego de saída na porta 3306. Verifique as configurações do seu firewall.

Elimine a possibilidade de problema no lado do cliente:

Tente conectar-se usando um cliente diferente para confirmar se o problema é específico do cliente atual. Para instruções de conexão por mecanismo, consulte:

Conexão de ECS para RDS via rede interna

Se uma instância ECS não conseguir se conectar a uma instância RDS pela rede interna, consulte What do I do if I fail to connect to an ApsaraDB RDS instance?.

Escopo de aplicação

ApsaraDB RDS.