All Products
Search
Document Center

ApsaraDB RDS:How do I troubleshoot the failure to connect to an ApsaraDB RDS instance?

Last Updated:Apr 21, 2025

This topic describes how to troubleshoot the failure to connect to an ApsaraDB RDS instance.

Overview

You can perform the following operations to troubleshoot the failure:

Step 1: Check the instance status and instance connection information

  1. Log on to the ApsaraDB RDS console. On the Instances page, view the status of your RDS instance. If your RDS instance is in an abnormal state, such as locked, resolve the issue based on the instructions provided in What do I do if my ApsaraDB RDS for MySQL instance is automatically locked due to exhausted storage capacity? If the RDS instance is locked, you cannot use your application to perform read or write operations on the instance. In this case, you can restart your RDS instance after you confirm that the restart does not affect your workloads. Proceed with caution.

  2. In the code or tool that is used to connect to the RDS instance, check whether connection information is valid. Specifically, check whether the internal and public endpoints are valid. For more information, see How do I connect to an ApsaraDB RDS instance?

    89aa015bccf2b7bf272329cdb8b63798

Step 2: Check whether the whitelist is correctly configured

Make sure that the IP address of the on-premises device that you want to connect to the RDS instance is added to an IP address whitelist of the RDS instance. Temporarily add the 0.0.0.0/0 entry to the IP address whitelist of the RDS instance. If the on-premises device can be connected to the RDS instance after 0.0.0.0/0 is added to the IP address whitelist, the device IP address that you added to the IP address whitelist is incorrect. In this case, remove the 0.0.0.0/0 entry and add the correct IP addresses to the whitelist. You can configure a whitelist based on the instructions provided in Step 2: Connect to an ApsaraDB RDS for MySQL instance. The following list describes the usage notes of the whitelist:

Step 3: Check instance performance

You can check the performance monitoring of the RDS instance to determine whether instance resources are insufficient.

Step 4: Check the network and client of the on-premises device

Failed to connect an ECS instance to an RDS instance over an internal network

If you cannot connect an ECS instance to an RDS instance over an internal network, you can resolve the issue based on the instructions provided in What do I do if I fail to connect to an ApsaraDB RDS instance?

Applicable scope

ApsaraDB RDS