Azure部署WordPress网站失败：数据库连接权限错误求助

碰到这个socket权限错误导致的数据库连接问题，是Azure部署WordPress时的常见坑，我帮你一步步排查解决：

1. 先找到正确的数据库完整用户名 #

你在phpMyAdmin里看到的azure只是用户名的前缀，Azure数据库的完整用户名格式是 {用户名}@{数据库服务器名称}，比如azure@my-wordpress-db-server，这才是WordPress需要的正确用户名。你可以通过两种方式获取：

• 从Azure门户查看：
  登录Azure门户，找到你用的数据库服务（比如Azure Database for MySQL），左侧菜单选择「连接字符串」，在MySQL的连接字符串里，user字段就是完整的用户名，直接复制即可。
• 在phpMyAdmin里确认：
  登录phpMyAdmin后，点击顶部的「用户账户」，找到对应的用户条目，查看完整的用户名（通常会显示为azure@%或者带服务器后缀的格式），复制这个完整值。

2. 修正WordPress的wp-config.php配置 #

找到网站根目录下的wp-config.php文件，确保以下核心配置项正确：

// 数据库名称
define( 'DB_NAME', '你的数据库名称' );

// 数据库完整用户名（就是刚才找到的带服务器后缀的那个）
define( 'DB_USER', 'azure@your-db-server-name' );

// 数据库用户密码（你为该用户设置的密码，不是Azure门户管理员密码）
define( 'DB_PASSWORD', '你的数据库密码' );

// 数据库主机（Azure数据库的完整主机名，比如your-db-server.mysql.database.azure.com）
define( 'DB_HOST', '你的数据库主机名' );

另外，Azure的数据库默认要求SSL连接，所以需要在wp-config.php里添加一行强制启用SSL：

define('MYSQL_CLIENT_FLAGS', MYSQLI_CLIENT_SSL);

注意：绝对不要把DB_HOST设为localhost或127.0.0.1，因为Azure数据库是远程服务，必须用完整的主机名通过TCP/IP连接，这也是导致socket权限错误的常见原因——WordPress尝试用本地socket连接远程数据库，自然会被权限拒绝。

3. 排查网络与防火墙问题 #

如果配置都正确还是报错，检查这两个点：

• 数据库防火墙规则：
  在Azure门户的数据库服务页面，左侧菜单选「防火墙和虚拟网络」，确保已经添加了你的Web App的出站IP地址（可以在Web App的「属性」页面找到出站IP列表），或者临时勾选「允许Azure服务和资源访问此服务器」（测试用，生产环境建议限制具体IP）。
• Web App的PHP版本兼容性：
  进入Web App的「配置」->「常规设置」，确认PHP版本符合WordPress的要求（建议PHP 7.4及以上），过低的版本可能会导致数据库驱动不兼容。

4. 测试数据库连接（可选） #

如果不确定是配置还是网络问题，可以在Web App根目录创建一个test-db.php文件，内容如下：

<?php
$servername = "你的DB_HOST";
$username = "你的完整DB_USER";
$password = "你的DB_PASSWORD";
$dbname = "你的DB_NAME";

// 创建带SSL的连接
$conn = new mysqli($servername, $username, $password, $dbname, 3306, null, MYSQLI_CLIENT_SSL);

// 检查连接
if ($conn->connect_error) {
  die("连接失败: " . $conn->connect_error);
}
echo "数据库连接成功！";
?>

访问https://websitename.azurewebsites.net/test-db.php，如果显示连接成功，说明网络和数据库凭证没问题，再回头检查WordPress的wp-config.php配置即可。

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