Verify Your wp-config.php Database Credentials

This is the most common culprit when your wordpress can't connect to database. Access your site's files via FTP/SFTP or your hosting control panel's file manager. Locate the wp-config.php file in your WordPress root directory. Open it and carefully check the DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST values. These must exactly match the credentials provided by your hosting provider for your MySQL database. Even a single typo will result in the "Error Establishing a Database Connection" message.

define('DB_NAME', 'your_database_name');
define('DB_USER', 'your_database_username');
define('DB_PASSWORD', 'your_database_password');
define('DB_HOST', 'localhost'); // Often 'localhost', but sometimes an IP or hostname

✓ 5-10 minutes. Ensure no leading/trailing spaces or incorrect characters. If you recently changed hosts or migrated, this is almost certainly the issue. For a deeper dive, see our guide on WordPress Database Credentials and Configuration Errors.

Check Your Database Server Status

If credentials are correct, the next most likely cause is that your database server is down or unreachable. This often leads to a wordpress site down database error. Log into your hosting control panel (cPanel, Plesk, custom panel). Look for a "MySQL Databases" or "Services Status" section. Confirm that your MySQL/MariaDB service is running. If you have SSH access, you can try to connect directly:

mysql -u your_database_username -p -h your_database_host

Enter your password when prompted. If you can't connect, or the command fails, the database server itself may be offline or blocked by a firewall. Contact your host immediately if you suspect the server is down.

✓ 5-15 minutes. This requires hosting panel access or basic SSH knowledge. If your host confirms the server is up, proceed to the next step.

Repair Your WordPress Database

Sometimes, a sudden server crash or plugin conflict can corrupt database tables, leading to a wordpress database connection failed completely message, or a wordpress error establishing database connection white screen. WordPress has a built-in repair utility. To enable it, add the following line to your wp-config.php file, ideally just above the /* That's all, stop editing! Happy publishing. */ line:

define('WP_ALLOW_REPAIR', true);

Save the file, then visit http://yourdomain.com/wp-admin/maint/repair.php in your browser. You'll see options to "Repair Database" or "Repair and Optimize Database." Choose either. Important: After the repair, remove the define('WP_ALLOW_REPAIR', true); line from wp-config.php for security reasons. For more detailed steps, refer to our guide on WordPress Database Corrupted or Crashed Fix.

✓ 10-20 minutes. This can resolve issues like "Table 'wp_posts' is marked as crashed."

Check for DB_HOST Issues, Especially After Migration

The DB_HOST value in wp-config.php is critical. While localhost is common, some hosts use specific IP addresses or hostnames (e.g., mysql.yourdomain.com). If you recently migrated your site or changed hosting providers, this value is highly likely to be incorrect. Double-check with your new host for the exact DB_HOST. Incorrect DB_HOST settings are a primary cause for a wordpress database connection error after migration. If you've just moved your site, this is the first place to look after credentials. This also applies to issues like WooCommerce Not Working After Migration to New Host or Domain Change, as database connectivity is fundamental.

✓ 5-10 minutes. Crucial for recently migrated sites. See our dedicated guide: WordPress Database Connection Error After Migration or Host Change.

Investigate "Too Many Connections" and PHP Version

If the error is intermittent, appearing and disappearing, especially under high traffic, your database might be hitting its connection limit. This is a common cause of a wordpress site blank database connection issue. Your hosting provider sets a max_connections limit for your MySQL server. When exceeded, new connections (like those from WordPress) are rejected. You might see "Too many connections" in your server logs. Contact your host to increase this limit or optimize your site to reduce database queries. Also, an incompatible PHP version (e.g., a recent PHP upgrade) can sometimes cause unexpected database connection issues, especially with older WordPress versions or plugins. Ensure your PHP version is compatible with your WordPress installation.

✓ 15-30 minutes (requires host interaction). For persistent "Too Many Connections" issues, consult our guide: WordPress Too Many Database Connections and Intermittent DB Errors.