WordPress配置凭据正确仍数据库连接失败，测试文件可正常连接求助

这种情况确实挺挠头的——明明测试脚本用相同的数据库凭据能正常连接，可WordPress的首页就是报“Error establishing a database connection”错误，我帮你梳理几个大概率的原因，你可以逐一排查：

1. wp-config.php里的凭据存在隐性细节问题 #

你说用了和test.php相同的凭据，但可能忽略了这些容易踩坑的点：

• 多余空格：比如DB_USER或DB_PASSWORD的定义里，值的前后不小心加了空格，比如define('DB_PASSWORD', 'password ');——test.php里你直接写的是干净的字符串，但wp-config里的空格会导致验证失败。
• 引号或特殊字符问题：如果数据库密码里包含单引号、双引号或者反斜杠这类特殊字符，wp-config里的定义有没有正确转义？比如密码是pa'ssword，就要写成define('DB_PASSWORD', 'pa\'ssword');。
• DB_HOST配置差异：有些服务器环境下，localhost无法正常解析，需要换成127.0.0.1，或者加上端口号（比如localhost:3306）。你test.php里用的是localhost，可以检查wp-config里的DB_HOST是不是和这个完全一致。

2. WordPress的数据库连接函数适配问题 #

你的test.php用的是mysqli_connect，但WordPress的数据库连接逻辑可能出现了适配问题：

• 如果你的PHP版本是7.0+，旧的mysql_*函数已经被废弃，如果wp-config里有define('WP_USE_EXT_MYSQL', true);这样的设置，会强制WordPress使用已废弃的旧函数，导致连接失败。建议删掉这行设置，或者改成define('WP_USE_EXT_MYSQL', false);，让WordPress自动使用mysqli扩展。

3. 文件权限异常 #

虽然test.php能正常运行，但wp-config.php或index.php的权限可能不符合服务器要求，导致WordPress无法读取配置：

• 把wp-config.php的权限改成644，index.php改成644，网站目录的权限改成755——避免权限过高（比如777）被服务器拦截，也确保Web服务器用户（比如www-data、apache）能读取配置文件。

4. 数据库用户的权限或访问限制 #

可以检查一下数据库用户的权限设置：

• 登录数据库执行SHOW GRANTS FOR 'username'@'localhost';，确认该用户拥有WordPress所需的SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP等权限，并且允许访问的主机是localhost（和你test.php里的连接主机一致）。

5. 缓存或插件/主题冲突 #

如果之前WordPress是正常运行的，突然出现这个问题：

• 先清空浏览器缓存，或者用无痕模式访问；如果用了缓存插件，直接把wp-content/plugins目录重命名为plugins_old，禁用所有插件后再试。
• 要是还不行，把当前使用的主题目录重命名，让WordPress fallback到默认主题（比如Twenty Twenty-Four），排查是不是主题代码干扰了数据库连接。

另外，你的test.php里有个小细节需要修正：你用了mysqli_connect建立连接，但错误提示用的是旧的mysql_error()，关闭连接用的是mysql_close()，这两个函数和mysqli扩展不兼容，虽然这次没影响，但建议改成：

<?php 
$link = mysqli_connect('localhost', 'username', 'password', 'dbname'); 
if (!$link) { 
    die('Could not connect: ' . mysqli_error($link)); 
} 
echo 'Connected successfully'; 
mysqli_close($link); 
?>

内容的提问来源于stack exchange，提问作者Anirudh