搭建WordPress时无法连接MySQL数据库，请求技术协助

1. 检查MySQL用户的主机访问权限 #

• 登录MySQL控制台执行：

  SELECT user, host FROM mysql.user;
  

  查看你用于WP连接的用户（比如root）的host字段：
  • 如果是localhost，仅允许socket连接，WP用127.0.0.1作为主机时会失败；
  • 执行以下命令授权用户通过TCP/IP访问（以root为例，建议创建专用WP用户）：

    -- 给root授权127.0.0.1访问wordpress库
    GRANT ALL PRIVILEGES ON wordpress.* TO 'root'@'127.0.0.1' IDENTIFIED BY '你的数据库密码';
    FLUSH PRIVILEGES;
    
    -- 推荐创建专用WP用户（更安全）
    CREATE USER 'wp_user'@'127.0.0.1' IDENTIFIED BY 'wp专用密码';
    GRANT ALL PRIVILEGES ON wordpress.* TO 'wp_user'@'127.0.0.1';
    FLUSH PRIVILEGES;
    

2. 核对WordPress数据库配置参数 #

• 确保WP安装页面填写的参数与MySQL配置完全一致：
  • 数据库名：确认是wordpress（Linux系统下MySQL库名区分大小写）；
  • 用户名：填刚才授权的用户（root或专用WP用户）；
  • 密码：与MySQL用户密码完全匹配，注意特殊字符转义；
  • 数据库主机：若授权了127.0.0.1，则填写127.0.0.1；若用localhost，需确保MySQL socket路径正确，可在wp-config.php中指定：

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

    （socket路径根据你的系统调整，比如Windows可能是localhost:3306或特定管道路径）

3. 检查MySQL网络监听配置 #

• 打开MySQL配置文件（Linux为/etc/my.cnf或/etc/mysql/my.cnf，Windows为my.ini）：
  • 查看bind-address参数，确保设置为127.0.0.1（允许本地TCP连接），若注释则允许所有IP（本地开发不建议）；
  • 检查是否有skip-networking参数，若存在则注释掉，该参数会禁用TCP/IP连接；
  • 修改后重启MySQL服务：

    # Linux
    sudo systemctl restart mysql
    # Windows
    net stop mysql && net start mysql
    

4. 测试MySQL TCP连接可用性 #

• 在命令行执行以下命令测试连接：

  # 测试127.0.0.1:3306是否可连接
  telnet 127.0.0.1 3306
  # 或用nc工具（若已安装）
  nc -zv 127.0.0.1 3306
  

  若连接失败，说明MySQL未监听TCP端口，需回到步骤3检查配置。

5. 查看WordPress详细错误日志 #

• 开启WP调试模式，找到wp-config.php文件（若未生成则复制wp-config-sample.php重命名），添加以下代码：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  

• 重新访问WP安装页面，查看wp-content/debug.log文件，里面会记录具体的连接错误原因（如密码错误、权限不足、主机不可达等），帮助精准定位问题。

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