在Windows 11的WSL中搭建MySQL 8.0：从权限陷阱到高效远程访问的深度实践
最近在帮几位同事配置本地开发环境时，我发现一个挺有意思的现象：很多开发者，尤其是习惯了macOS或纯Linux环境的朋友，初次在Windows 11的WSL（Windows Subsystem for Linux）里安装MySQL 8.0时，总会踩进几个相同的“坑”。表面上看，步骤和纯Linux服务器上没什么两样，但WSL这个特殊的“中间层”环境，加上MySQL 8.0自身在安全策略上的收紧，让一些原本简单的操作变得有点棘手。最常见的莫过于那个让人摸不着头脑的ERROR 1396 (HY000)，以及费了半天劲却发现从宿主机Windows依然连不上数据库的窘境。
这篇文章，我想从一个实际踩坑者的角度，和你聊聊在WSL 2（特别是Ubuntu发行版）上部署MySQL 8.0的完整心路历程。我们不止要解决报错，更要理解背后的“为什么”——比如WSL的网络架构如何影响数据库连接，MySQL 8.0的默认认证插件caching_sha2_password为何有时会成为拦路虎，以及如何安全地配置远程访问而不至于门户大开。最后，我还会提供一个基于Docker的备选方案，并分享几个提升WSL内MySQL性能的小技巧，希望能帮你构建一个既稳固又高效的本地数据库开发环境。
1. 环境准备与MySQL安装：避开第一个雷区
在WSL中安装软件，很多人的第一反应是打开终端，直接sudo apt install mysql-server。这本身没错，但为了后续少些麻烦，我建议先做两件小事。
首先，更新你的软件源列表。虽然听起来是老生常谈，但WSL安装的Ubuntu镜像有时初始源不是最新的，直接安装可能会遇到版本老旧或依赖问题。
sudo apt update && sudo apt upgrade -y
接下来，安装MySQL服务器。在Ubuntu 22.04或24.04的仓库中，默认提供的已经是MySQL 8.0系列。
sudo apt install mysql-server -y
安装过程通常很顺利，完成后MySQL服务会自动启动。你可以用以下命令检查它的状态：
sudo systemctl status mysql
如果看到active (running)的字样，说明MySQL服务已经在后台跑起来了。到这里，一切似乎都很美好。但第一个“坑”往往出现在你第一次尝试设置root密码的时候。按照许多老教程的做法，可能会直接运行sudo mysql_secure_installation这个安全安装脚本。但在WSL环境下，我强烈建议你先别急着运行它。
提示：
mysql_secure_installation脚本会引导你进行一系列安全设置，包括设置root密码、移除匿名用户、禁止root远程登录等。问题在于，在MySQL 8.0的某些安装方式下，初始的root用户认证方式可能比较特殊，直接运行脚本修改密码可能会触发权限错误。我们最好先手动进入MySQL控制台看看情况。
2. 破解ERROR 1396：理解用户与主机的绑定关系
安装完成后，我们尝试用MySQL自带的命令行客户端连接。由于刚安装完，root用户默认是通过一种叫做auth_socket的插件进行认证的，这允许本地的系统用户无需密码就能以root身份登录MySQL。在WSL的终端里，你可以这样进入：
sudo mysql
成功进入后，你会看到mysql>提示符。现在，假设我们想给root用户设置一个密码，并允许它从任何主机（%）连接，以便后续从Windows宿主机的数据库工具（如DataGrip、DBeaver）进行访问。一个很自然的想法是执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourStrongPassword123!';
或者，如果你想允许远程连接：
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'YourStrongPassword123!';
就是这里，ERROR 1396 (HY000): Operation ALTER USER failed for 'root'@'%'这个错误很可能就跳出来了。 我第一次遇到时也愣了一下，密码明明符合复杂度要求，语法也没错，为什么不行？
问题的根源在于 MySQL用户是由“用户名”和“主机名”共同唯一确定的。'root'@'localhost'和'root'@'%'在MySQL看来是两个完全不同的用户账户。默认安装后，可能只存在'root'@'localhost'这个用户，而不存在'root'@'%'。当你试图修改一个不存在的用户时，自然就会报1396错误。
解决思路不是强行修改，而是先查看、再创建或修改。让我们一步步来：
-
查看当前存在的用户： 在
mysql>提示符下，切换到mysql系统数据库，并查看user表。USE mysql; SELECT user, host, plugin FROM user;你可能会看到类似这样的结果：
user host plugin root localhost auth_socket mysql.session localhost mysql_native_password mysql.sys localhost mysql_native_password debian-sys-maint localhost caching_sha2_password 注意，这里只有
'root'@'localhost'，没有'root'@'%'。 -
方案选择：修改现有用户或创建新用户
- 方案A（推荐，更安全）： 直接修改现有的
'root'@'localhost'用户，但将其主机改为%，并更改认证插件和密码。
执行后，再运行修改密码的命令：UPDATE user SET host='%' WHERE user='root'; FLUSH PRIVILEGES;ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'YourStrongPassword123!'; FLUSH PRIVILEGES; - 方案B： 创建一个新的、允许远程连接的root用户（或更推荐，创建一个具有所需权限的专用管理用户）。
CREATE USER 'admin'@'%' IDENTIFIED WITH mysql_native_password BY 'YourStrongAdminPass456!'; GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;
这里我选择了
mysql_native_password插件，是因为一些较老的客户端或工具可能还不完全兼容MySQL 8.0默认的caching_sha2_password插件。虽然caching_sha2_password更安全，但在开发环境，为了兼容性，先使用前者可以避免一些连接问题。当然，你也可以直接使用caching_sha2_password，只要你的客户端支持。 - 方案A（推荐，更安全）： 直接修改现有的
注意：将root用户的host改为
%意味着允许从任何IP地址以root身份连接，这在生产环境是极大的安全隐患。但对于封闭的本地开发环境（WSL），为了方便可以这样设置。如果你追求更高安全性，务必采用方案B，创建专用账户。
完成上述操作后，退出MySQL (exit)，然后重启MySQL服务使更改生效：
sudo systemctl restart mysql
现在，ERROR 1396应该已经被解决了。但仅仅这样，你很可能还是无法从Windows主机连接到WSL里的MySQL。
3. 打通网络壁垒：配置MySQL监听与WSL防火墙
在WSL 2架构下，Linux子系统运行在一个轻量级的虚拟机上，拥有独立的虚拟网络。默认情况下，MySQL只绑定在127.0.0.1（即localhost）上，这意味着它只接受来自WSL内部的连接。要从Windows宿主机访问，我们需要让MySQL监听所有网络接口。
-
修改MySQL绑定地址： 找到MySQL的配置文件，通常位于
/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/mysql/my.cnf。sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf找到
bind-address这一行（大约在30多行）。默认是：bind-address = 127.0.0.1将其改为：
bind-address = 0.0.0.0这告诉MySQL监听所有可用的IPv4网络接口。如果你看到
mysqlx-bind-address（这是MySQL X Protocol的配置），出于同样的远程访问目的，也可以将其改为0.0.0.0。保存并退出编辑器。
-
处理WSL 2的防火墙（如果存在）： WSL 2默认集成了Windows Defender防火墙的配置，通常不需要在WSL内部额外配置
ufw（如果安装了的话）。但为了确保万无一失，我们可以检查一下。如果你的WSL发行版安装了ufw，确保它没有阻止3306端口。# 检查ufw状态 sudo ufw status # 如果状态是inactive，则防火墙未启用，无需担心。 # 如果是active，确保3306端口是允许的 sudo ufw allow 3306/tcp -
重启MySQL服务：
sudo systemctl restart mysql -
获取WSL 2的IP地址： 在WSL 2中，每次启动分配的IP地址可能都会变化。要从Windows连接，你需要知道WSL实例当前的IP。在WSL终端里运行：
ip addr show eth0 | grep inet你会看到一个类似
inet 172.xx.xx.xx/20的地址，记下这个172.xx.xx.xx。
现在，回到你的Windows系统，打开任何数据库客户端（如MySQL Workbench、DBeaver），尝试新建一个连接：
- 主机名/IP地址： 填入刚才获取的WSL IP（例如
172.25.218.210） - 端口：
3306 - 用户名： 你之前配置的
root或admin - 密码： 你设置的密码
点击连接，如果一切配置正确，你应该能成功连上WSL里的MySQL数据库了。
4. Docker方案：更灵活、更干净的替代选择
如果你觉得上述原生安装和配置过程有些繁琐，或者你希望有一个更隔离、更容易复现和销毁的环境，那么使用Docker来运行MySQL是一个绝佳的选择。WSL 2对Docker Desktop的支持已经非常完善。
-
在WSL中安装Docker： 如果你还没有安装Docker，可以参考官方文档。一个快速的方法是：
# 卸载旧版本（如有） sudo apt-get remove docker docker-engine docker.io containerd runc # 安装依赖 sudo apt-get update sudo apt-get install ca-certificates curl gnupg # 添加Docker官方GPG密钥 sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg # 设置仓库 echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 安装Docker引擎 sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 将当前用户加入docker组，避免每次用sudo sudo usermod -aG docker $USER # 需要退出终端重新登录才能生效 -
使用Docker运行MySQL 8.0： 一条命令即可启动一个MySQL容器：
docker run -d \ --name mysql-dev \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=YourStrongRootPass123! \ -e MYSQL_DATABASE=myapp \ -e MYSQL_USER=devuser \ -e MYSQL_PASSWORD=DevUserPass456! \ -v mysql_dev_data:/var/lib/mysql \ mysql:8.0 \ --default-authentication-plugin=mysql_native_password让我解释一下这些参数：
-d: 后台运行。--name: 给容器起个名字，方便管理。-p 3306:3306: 端口映射，将容器内的3306端口映射到WSL的3306端口。-e: 设置环境变量，这里初始化了root密码、创建了一个数据库和一个普通用户。-v: 数据卷挂载，将容器内的数据持久化到名为mysql_dev_data的卷中，即使容器删除，数据也不会丢失。mysql:8.0: 指定镜像和版本。--default-authentication-plugin: 这里显式指定了默认认证插件，避免客户端兼容性问题。
-
连接Docker中的MySQL： 容器启动后，从Windows宿主机连接的方式和之前完全一样，使用WSL的IP地址和映射的端口（3306）。Docker方案的优势在于：
- 隔离性： 数据库环境与宿主机系统完全隔离，不会污染WSL。
- 一致性： 镜像保证了环境的一致性，在任何机器上运行结果相同。
- 便捷性： 启动、停止、删除、版本切换极其方便。
- 资源管理： 可以方便地通过Docker命令限制CPU和内存使用。
5. 性能调优与日常维护建议
无论是原生安装还是Docker运行，在WSL这个特殊环境下运行MySQL，有一些调优点值得关注，能让你的开发体验更流畅。
-
调整InnoDB缓冲池大小： WSL通常分配的内存有限（默认是主机内存的50%）。对于开发环境，不需要设置太大的缓冲池。编辑MySQL配置文件（
/etc/mysql/mysql.conf.d/mysqld.cnf），在[mysqld]部分添加或修改：innodb_buffer_pool_size = 256M这个值可以根据你WSL分配的总内存来调整，一般设为可用内存的50%-70%比较合适。
-
优化WSL 2的.vhdx磁盘性能： MySQL的IO操作比较频繁。WSL 2的虚拟硬盘文件（.vhdx）默认位于Windows的
%USERPROFILE%目录下。你可以考虑将其移动到更快的SSD盘上，或者通过Windows的“存储感知”功能确保该驱动器有足够的可用空间并进行碎片整理（针对HDD）。在WSL内部，也可以考虑将MySQL的数据目录放在WSL发行版的根文件系统（如/var/lib/mysql）而不是挂载的Windows驱动器（/mnt/c/...）上，因为后者跨系统文件操作性能损耗较大。 -
配置合理的日志输出： 开发环境不需要记录太详细的日志，避免日志文件膨胀占用空间。可以检查配置文件中的
general_log、slow_query_log等设置，如非必要，将其关闭。 -
使用连接池管理： 如果你的应用频繁连接数据库，考虑在应用层使用连接池（如HikariCP），减少建立和断开连接的开销，这对提升WSL环境下的响应速度也有帮助。
-
定期备份与快照： WSL的一个便利之处是可以导出整个发行版。在你配置好一个满意的开发环境（包括MySQL数据）后，可以使用
wsl --export命令将其备份为一个tar文件。当环境被意外破坏时，可以快速导入恢复。
折腾WSL里的MySQL，从报错到连通，再到选择更优的Docker方案和进行简单调优，这个过程本身也是对现代开发环境混合架构的一次深入理解。我自己的习惯是，对于需要长期稳定、数据重要的项目，用Docker容器来跑数据库，干净利落；而对于快速测试、临时查询，原生安装的MySQL也足够方便。关键在于，清楚了每个选择背后的网络、权限和性能逻辑，就能在任何环境下都游刃有余。希望这些具体的步骤和背后的思考，能让你下次再面对ERROR 1396时，不再感到困惑，而是能自信地快速定位并解决它。
1万+
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
