Troubleshoot connection issues to Azure Database for MySQL - Flexible Server

[APPLIES TO: Azure Database for MySQL - Flexible Server

Connection problems may be caused by a variety of things, including:

  • Firewall settings
  • Connection time-out
  • Incorrect login information
  • Maximum limit reached on some Azure Database for MySQL Flexible Server resources

In this article, we will discuss how you can troubleshoot some of the common errors and steps to resolve these errors.

Troubleshoot common errors

If the application persistently fails to connect to Azure Database for MySQL Flexible Server, it usually indicates an issue with one of the following:

  • Flexible Server in Private access (VNet Integration): Make sure you are connecting from within the same virtual network as the flexible server. Refer to [virtual network in Azure Database for MySQL Flexible Server]
  • Flexible Server with Public access (allowed IP addresses), make sure that the firewall is configured to allow connections from your client. Refer to Create and manage flexible server firewall rules using the Azure portal.
  • Client firewall configuration: The firewall on your client must allow connections to your database server. IP addresses and ports of the server that you cannot to must be allowed as well as application names such as MySQL in some firewalls.
  • User error: You might have mistyped connection parameters, such as the server name in the connection string.

Resolve connectivity issues

  • Refer to encrypted connectivity using Transport Layer Security (TLS 1.2) in Azure Database for MySQL - Flexible Server --> to learn more about encrypted connections.
  • If you are using Public access (allowed IP addresses), then set up firewall rules to allow the client IP address. For temporary testing purposes only, set up a firewall rule using as the starting IP address and using as the ending IP address. This will open the server to all IP addresses. If this resolves your connectivity issue, remove this rule and create a firewall rule for an appropriately limited IP address or address range.
  • On all firewalls between the client and the internet, make sure that port 3306 is open for outbound connections.
  • Verify your connection string and other connection settings. Refer to the pre-defined connection strings in the Connection Strings page available for your server in the Azure portal for common languages.

Next steps