使用localhost时WordPress自定义用户无法连接MySQL问题排查

1. 为何WordPress用youssef+localhost连接失败？ #

MySQL对localhost和127.0.0.1的连接逻辑存在本质区别：

• 指定localhost时，MySQL默认使用Unix Socket文件建立连接，而非TCP/IP端口；
• 指定127.0.0.1时则强制走TCP/IP协议连接。

问题的核心原因：

• 你在命令行能用youssef@localhost连接，是因为命令行以当前操作系统用户（youssef）的身份访问socket文件；但WordPress运行在Apache/PHP进程下，默认使用www-data用户身份；
• 要么是youssef用户的localhost身份验证方式为auth_socket（这种验证依赖操作系统用户匹配，www-data不是youssef，无法通过）；要么是MySQL的socket文件权限限制了www-data用户的访问；
• 而root@localhost通常使用mysql_native_password验证，且root拥有更高的socket访问权限，因此能正常连接。

2. 解决方法 #

方法一：修改youssef用户的localhost验证方式 #

登录MySQL命令行，执行以下命令：

ALTER USER 'youssef'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的用户密码';
FLUSH PRIVILEGES;

该操作将用户验证切换为密码验证，不再依赖操作系统用户匹配，PHP进程（www-data）即可通过socket正常连接。

方法二：在wp-config.php中明确指定socket路径 #

先确认MySQL的socket文件路径，可通过以下命令查询：

mysql_config --socket

常见路径为/var/run/mysqld/mysqld.sock，随后修改wp-config.php中的DB_HOST配置：

define('DB_HOST', 'localhost:/var/run/mysqld/mysqld.sock');

通过明确指定socket路径，确保PHP能定位到正确的连接文件。

方法三：调整socket文件的访问权限 #

先查看socket文件的当前权限：

ls -l /var/run/mysqld/mysqld.sock

若权限为mysql:mysql，可将www-data用户加入mysql组：

sudo usermod -aG mysql www-data
sudo systemctl restart apache2

（注：不建议长期使用chmod 777修改socket权限，存在安全风险）

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