如何在WSL 2中搭建低延迟的MySQL本地开发测试环境-mysql教程-PHP中文网

WSL2中MySQL默认无法被Windows直连且本地命令行报错2002，需同步修正socket路径、bind-address、远程用户权限及DNS解析四点：先建/tmp/mysql.sock软链接指向/var/run/mysqld/mysqld.sock；将mysqld.cnf中bind-address改为0.0.0.0并开放Windows防火墙3306端口；新建dev@'%'用户而非修改root@'%'；添加skip-name-resolve提升连接速度。

如何在wsl 2中搭建低延迟的mysql本地开发测试环境

直接用 apt install mysql-server 装出来的 MySQL 在 WSL2 里默认不能被 Windows 主机直连，且本地命令行常报 ERROR 2002 (HY000): Can't connect to local MySQL server through socket——这不是装错了，是 socket 路径、绑定地址、权限三处没对齐。

mysql 命令连不上？先修 socket 软链接

WSL2 中 MySQL 服务端实际把 socket 文件建在 /var/run/mysqld/mysqld.sock，但客户端（比如你敲 mysql -u root -p）默认去找 /tmp/mysql.sock，路径不一致就直接报错。

执行这句就能桥接：

sudo ln -sf /var/run/mysqld/mysqld.sock /tmp/mysql.sock

之后所有本地命令行连接都会走通。注意：这个软链接必须每次安装完 MySQL 后手动补上，apt 不会自动创建。

Windows 连不上 3306？改 bind-address + 开防火墙

WSL2 的网络是虚拟网卡，IP 动态分配（通常形如 172.x.x.1），而 MySQL 默认只监听 127.0.0.1，导致 Windows 主机用 localhost:3306 或 127.0.0.1:3306 都连不通。

编辑配置：sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
找到 bind-address = 127.0.0.1，改成 bind-address = 0.0.0.0（或直接注释掉整行）
重启服务：sudo service mysql restart
确认监听生效：sudo ss -tlnp | grep :3306，输出应含 *:3306，不是 127.0.0.1:3306
Windows 防火墙必须放行入站 TCP 3306 端口（仅靠 WSL2 设置不够）

远程用户连了但权限拒绝？别动 root@localhost，另建 % 用户

MySQL 8.0 默认用 auth_socket 插件认证 root@localhost，它不认密码，也不接受远程连接。硬改 root@'%' 容易引发后续升级或工具兼容问题。

更稳妥的做法是保留 root@localhost 本地管理，额外建一个专供开发连接的用户：

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

sudo mysql -u root<br>CREATE USER 'dev'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';<br>GRANT ALL PRIVILEGES ON *.* TO 'dev'@'%' WITH GRANT OPTION;<br>FLUSH PRIVILEGES;

这样既避开插件冲突，又避免暴露 root 远程权限。注意：MySQL 8.0 对 @'%' 和 @'localhost' 视为两个完全独立的账号，不能混用。