MacBook本地MySQL可正常访问，但全新WordPress安装时无法连接MySQL服务器

嘿，我来帮你排查这个问题——既然你已经能通过mysql -u root和Navicat正常访问MySQL，说明数据库服务本身是没问题的，大概率是WordPress的配置细节或者MySQL的权限设置导致的连接失败。下面是几个按优先级排序的排查步骤，一步步来：

1. 先核对WordPress安装页的配置细节 #

• 主机地址：别想当然填localhost，试试换成127.0.0.1。Mac上MySQL有时候对localhost的解析会走Unix Socket，而WordPress可能默认用TCP/IP连接，换成IP地址能避免这个兼容性问题。
• 用户名&密码：你用mysql -u root是无密码登录吗？那WordPress的密码栏一定要留空；如果root有密码，务必确认输入的密码和你登录MySQL时的一致。另外，更推荐给WordPress创建单独的数据库用户（后面会说），避免用root权限带来的风险。
• 数据库名称：有没有提前创建好WordPress要用的空数据库？比如你在MySQL里执行过CREATE DATABASE wordpress_db;吗？没创建的话先建一个。

2. 检查MySQL的用户权限设置 #

MySQL的权限是按「用户名+来源主机」组合判断的，哪怕你能本地用root登录，也可能存在权限范围不覆盖WordPress连接方式的情况：

• 先登录MySQL，执行这条命令查看root用户的授权主机：

  SELECT user, host FROM mysql.user WHERE user = 'root';
  

• 如果结果里root的host只有localhost，那WordPress用TCP/IP连接（对应127.0.0.1）时就会被拒绝。这时候可以给root添加127.0.0.1的访问权限，或者直接创建一个专门的WordPress用户：

  -- 创建WordPress专用用户（替换成你想要的用户名和密码）
  CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'your_secure_password';
  CREATE USER 'wp_user'@'127.0.0.1' IDENTIFIED BY 'your_secure_password';
  
  -- 给用户授权目标数据库的所有权限（替换成你的数据库名）
  GRANT ALL PRIVILEGES ON wordpress_db.* TO 'wp_user'@'localhost';
  GRANT ALL PRIVILEGES ON wordpress_db.* TO 'wp_user'@'127.0.0.1';
  
  -- 刷新权限使设置生效
  FLUSH PRIVILEGES;
  

• 之后用这个新用户的信息填写WordPress安装页，大概率能解决权限问题。

3. 确认MySQL的监听配置 #

有时候MySQL的绑定地址设置会限制TCP连接：

• 找到MySQL的配置文件（Homebrew安装的话通常是/usr/local/etc/my.cnf或/opt/homebrew/etc/my.cnf，系统自带的可能在/etc/my.cnf），查找bind-address这一行：
  • 如果它被设成127.0.0.1，那是正常的（允许本地TCP连接）；
  • 如果被注释掉或者设成localhost，可以改成127.0.0.1后重启MySQL服务：

    # Homebrew安装的MySQL重启命令
    brew services restart mysql
    

4. 检查PHP的MySQL扩展是否启用 #

WordPress依赖PHP的MySQL扩展来连接数据库，所以要确认你的PHP环境已经启用了对应扩展：

• 在Web服务器的根目录（比如MAMP的htdocs、Apache的DocumentRoot）新建一个phpinfo.php文件，内容如下：

  <?php phpinfo(); ?>
  

• 访问这个文件（比如http://localhost/phpinfo.php），搜索mysqli或pdo_mysql，如果找不到相关条目，说明扩展没启用：
  • 打开PHP的配置文件（比如php.ini），找到;extension=mysqli和;extension=pdo_mysql，去掉前面的分号，保存后重启Web服务器（Apache或Nginx）。

5. 排查Unix Socket的权限问题 #

如果WordPress尝试通过Unix Socket连接MySQL，可能会遇到权限不足的情况：

• 先在MySQL里查看socket文件路径：

  SHOW VARIABLES LIKE 'socket';
  

• 得到路径后（比如/tmp/mysql.sock），检查这个文件的权限是否允许Web服务器用户（比如_www或www-data）访问：

  ls -l /tmp/mysql.sock
  

• 如果权限不够，可以临时设置开放权限测试：

  sudo chmod 777 /tmp/mysql.sock
  

• 要是测试成功，再调整更安全的权限，比如把Web服务器用户加入MySQL用户组：

  sudo dseditgroup -o edit -a _www -t user mysql
  

按上面的步骤排查下来，基本能解决WordPress无法连接MySQL的问题。

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