1. 为什么非要在 Windows 上同时装两个 MySQL1.1 一个 3306 端口的痛谁遇到谁知道看到这个标题的人我猜十有八九都是同一个处境手里维护的老项目数据库跑在 MySQL 5.7 上新项目又明确要求 8.0两边谁都不能随便卸载。真去把 5.7 卸了装 8.0回头老项目一启动直接连不上库那场面我是见过的——代码没动、配置没动全部的错都出在数据库连不上查半天才发现是版本问题。还有一种更难受的情况公司测试环境、预发布环境用 5.7本地开发要用 8.0 来对齐新特性的行为差异。你总不能每次都把本地环境重装一遍。Windows 上的 MySQL 不像 Linux 那边用 docker 或者编译装那么随意默认安装器一跑就占 3306 端口、注册成系统服务后装的版本会跟旧服务打架。所以要解决的核心问题很简单让两个 MySQL 版本在同一台 Windows 机器上同时在线互不干扰随时可启停。这里说的“互不干扰”落到实处就三件事——端口不冲突、服务名不冲突、数据目录不重叠。把这三点规划好后面所有操作都是顺水推舟的事。1.2 方案对比虚拟机、Docker、双实例我先说下我走过的弯路帮大家排掉几个明显不如意的方案。第一个方案是用虚拟机装个 Linux 跑 5.7Windows 本机跑 8.0。好处是隔离彻底坏处是资源占用太大。你本地开发本来内存就不宽裕再开一个虚拟机风扇直接起飞。而且虚拟机里的数据库跟宿主机文件互通也麻烦数据导入导出都要绕一圈。第二个方案是 Docker Desktop。这个现在很多人用跑两个 MySQL 容器也确实是标准玩法。但我自己在 Windows 上试过几次启动 Docker Desktop 本身要占内存WSL2 后端偶尔还会出文件句柄问题。更重要的是很多做传统业务开发的朋友根本不熟悉 Docker与其让团队维护一份 docker-compose不如直接给一份“双击就能跑”的本地安装指南更实在。第三个方案就是今天要讲的两个 MySQL 直接装在同一台 Windows 上一个走 3306一个走 3307各自独立的目录、独立的数据文件夹、独立的服务名。这个方案的好处是零虚拟化开销、启动快、跟生产环境行为最接近排查问题的时候也能直接用本机的命令行工具连上去看不需要绕任何一层中间件。我后面所有实操用的都是这个“双实例并存”的思路。2. 动手前要做的三件事下载、规划、避坑2.1 下载 ZIP 版而不是 MSI 版很多人装 Windows 软件习惯性去找 MSI 安装包但这里我必须先劝一句要装两个版本共存一定选 ZIP 压缩包版别用 MSI 安装器。原因很简单MSI 安装器会帮你做一堆“自动化”操作包括注册服务、写注册表、设置环境变量、默认装到 Program Files。这些自动化动作在你只需要一个 MySQL 时确实省事但要装第二个版本时就成了灾难——它会去检测现有的 3306 端口、检查已有的服务然后在服务管理器里横插一脚经常装到一半报错或者装完后把原先的配置搞乱。ZIP 版就干净得多。解压完就是一个文件夹里面是 mysqld.exe、mysql.exe 这些可执行文件没有任何系统级改动。你想让这个版本当服务跑就手动注册服务你不想让它当服务直接启动前台进程也行。一切尽在掌握这就是共存的前提。找到 ZIP 版的下载入口也有讲究。官方网站下载页面里不要选“Windows (x86, 32-bit), MSI Installer”那个而是要找 “Windows (x86, 64-bit), ZIP Archive” 这类选项。5.7 系列的最终版本是 5.7.448.0 系列我建议用当前较新的 8.0.x 版本。2.2 端口、目录、服务名的规划这是整个方案里最重要的一步宁可多花五分钟想清楚也不要装到一半再改。我建议在动手前建一个小表格把两个实例的信息写清楚后面所有命令都对着这张表来。我自己的规划是这样实例版本端口安装目录数据目录服务名实例 AMySQL 8.03306D:\mysql\mysql-8.0D:\mysql\mysql-8.0\dataMySQL80实例 BMySQL 5.73307D:\mysql\mysql-5.7D:\mysql\mysql-5.7\dataMySQL57端口方面默认 3306 给 8.05.7 换成 3307这是最不容易出幺蛾子的分法。你以后连 5.7 的库时只要记得加-P3307就行。目录上我把两个版本放在同一个父目录下互不嵌套避免路径读取混乱。服务名也要刻意区分如果两个服务都叫 MySQL后注册的会把前面那个挤掉或者注册失败。还有一点容易被忽略数据目录千万不能共用。有些人图省事两个版本指向同一个 data 文件夹结果第二个版本初始化时直接把第一个版本的数据目录覆盖了数据全没。这个坑我在公司帮别人救过一次真的救不回来。所以规划阶段就要把每个实例的数据目录独立出来。2.3 环境变量与依赖运行库的处理接着是环境变量。很多人会习惯性地把两个 MySQL 的 bin 目录都加到 PATH 里我强烈不建议这么做。因为 PATH 里的 mysqld.exe 只能有一个生效两个都加进去执行 mysql 命令时到底用的是哪个版本完全取决于 PATH 里的先后顺序很容易搞混。我的做法是PATH 里只加常用那个版本另一个版本需要用命令行时直接打完整路径或者先 cd 到它的目录。如果你日常开发主要用 8.0就把 D:\mysql\mysql-8.0\bin 加到 PATH偶尔要连 5.7 时就显式用路径调用。另外Windows 上跑 MySQL 还依赖微软的 Visual C 运行库。ZIP 包本身不自动装这个如果你这台机器是精简系统运行 mysqld 时可能会提示缺少 DLL。建议提前到微软官网把最新的 Visual C 可再发行包装上一劳永逸省得到时候排查半天。3. 一步步实操两个版本从解压到跑起来3.1 第一个实例MySQL 8.0 作为主服务先把 8.0 的 ZIP 包解压到规划好的目录。假设解压后路径是 D:\mysql\mysql-8.0注意这个文件夹下应该直接就是 bin、lib 这些子目录。然后在 D:\mysql\mysql-8.0 下新建一个 my.ini 配置文件。这个文件是整个实例的“身份证”里面写清楚安装目录、数据目录、端口和默认字符集[mysqld] basedirD:/mysql/mysql-8.0 datadirD:/mysql/mysql-8.0/data port3306 character-set-serverutf8mb4 default-authentication-plugincaching_sha2_password [client] default-character-setutf8mb4写 ini 文件的时候注意一点里头的路径最好用正斜杠。Windows 下反斜杠是转义符写在 ini 里容易出解析问题虽然很多情况下也能跑但没必要去赌这个。接下来打开管理员权限的命令提示符或者 PowerShell先进入目录然后执行初始化命令cd /d D:\mysql\mysql-8.0 mysqld --defaults-fileD:/mysql/mysql-8.0/my.ini --initialize-insecure--initialize-insecure的意思是初始化数据目录并且让 root 账号的初始密码为空。等一下这里有个容易踩的坑如果 data 目录已经存在且不为空初始化会直接报错。所以确认一下 D:\mysql\mysql-8.0\data 这个文件夹要么不存在要么是空的。初始化完成后注册成 Windows 服务mysqld --defaults-fileD:/mysql/mysql-8.0/my.ini --install MySQL80命令里的 MySQL80 就是我们规划好的服务名。注册成功后启动服务net start MySQL80启动完之后用命令行验证一下mysql -uroot -P3306因为初始密码为空直接回车就能进去。进去以后第一件事是给 root 设置密码毕竟空密码太危险ALTER USER rootlocalhost IDENTIFIED BY 你的密码;到这里实例 A 就算跑起来了。3.2 第二个实例MySQL 5.7 作为独立服务接下来是 5.7。解压到 D:\mysql\mysql-5.7同样在目录下建 my.ini。注意端口这次一定要写成 3307不能再占用 3306[mysqld] basedirD:/mysql/mysql-5.7 datadirD:/mysql/mysql-5.7/data port3307 character-set-serverutf8mb4 [client] default-character-setutf8mb4然后同样做初始化注意使用你自己的目录cd /d D:\mysql\mysql-5.7 mysqld --defaults-fileD:/mysql/mysql-5.7/my.ini --initialize-insecure这里我多说一句5.7 的初始化方式跟 8.0 是同一个命令不需要用老教程里那个 mysql_install_db那个是 Linux/Unix 下的 Perl 脚本Windows 下直接用 --initialize 或 --initialize-insecure 就行。初始化完成后注册服务。这里有个细节服务名必须跟 8.0 那个区分开前面规划的是 MySQL57就用这个名字mysqld --defaults-fileD:/mysql/mysql-5.7/my.ini --install MySQL57 net start MySQL57连接测试时记得带上端口参数mysql -uroot -P3307如果你不想让 5.7 注册成自启动服务只想在需要的时候手动拉起来也可以用前台模式运行mysqld --defaults-fileD:/mysql/mysql-5.7/my.ini --console这个窗口会一直挂着关掉窗口或者按 CtrlC实例就停了。这种方式适合偶尔用一下的场景也适合调试启动问题因为所有日志会直接打到这个控制台窗口里比翻日志文件直观。3.3 验证两个实例同时在线两个都启动完之后别急着开心先做一轮系统的验证确保它们真的“同时在线”。第一个验证是查端口。打开命令提示符执行netstat -ano | findstr 3306 netstat -ano | findstr 3307如果两个端口都能看到监听中的记录说明端口层没问题。如果 3307 查不出东西多半是那边还没启动成功直接去翻数据目录里的 .err 日志。第二个验证是查服务状态。可以打开 services.msc也能用命令查sc query MySQL80 sc query MySQL57注意看 STATE 那行是不是 RUNNING。第三个验证是实际连上去看版本。用两个命令分别确认mysql -uroot -h127.0.0.1 -P3306 -e select version(); mysql -uroot -h127.0.0.1 -P3307 -e select version();第一个应该返回 8.0.x第二个返回 5.7.x这就说明两个独立实例都工作正常了。我这套流程已经帮同事在几台不同的 Windows 机器上验证过只要按上面的步骤走基本一遍过。4. 日常管理服务启停、命令行连接、配置修改4.1 服务启停的命令与细节装完之后就是日常使用了。两个服务在 Windows 服务管理器里分别叫 MySQL80 和 MySQL57启停命令很简单net start MySQL80 net stop MySQL80 net start MySQL57 net stop MySQL57这里有个小细节。如果你遇到net start提示“服务名无效”或者“服务尚未启动”先检查服务名是不是拼错了。服务名不区分大小写但拼写必须跟注册时一致。想看当前机器上有哪些 MySQL 相关服务执行sc query state all | findstr /i mysql如果你希望 5.7 这个服务开机不自动启动可以用 sc 命令改启动类型sc config MySQL57 start manual注意 sc 命令里start后面的空格不能省这是 Windows 命令行一个很诡异的规则少了空格会执行出错。改完之后MySQL57 就只会在你手动 net start 时才启动不会每天开机跟 8.0 抢资源。如果你哪天决定彻底不要某一个实例了先net stop停掉再mysqld --remove MySQL57卸载服务最后删文件夹就行。但删之前一定记得确认数据目录里的库表文件已经备份过了这个话我得反复强调。4.2 命令行连接不同实例命令行连接是每天都要用的技能。两个实例并存的日常场景大多数问题都出在“端口搞混了”。连接 8.0mysql -uroot -p -P3306连接 5.7mysql -uroot -p -P3307注意我用的是-h127.0.0.1而不是-hlocalhost。因为某些 Windows 版本下 localhost 会触发 MySQL 的 named pipe 连接逻辑而 8.0 的 named pipe 配置跟 5.7 又不一样搞不好就报“无法连接到命名管道”的错。干脆统一用 127.0.0.1走 TCP清清爽爽。如果你不习惯每次敲端口可以在自己的用户目录下建一个 my.cnf 文件把常用的连接参数写进去。比如默认连接 5.7 的话[client] host127.0.0.1 port3307 userroot password你的密码这样直接敲 mysql 就会自动用 3307。但要注意如果你又经常要连 8.0这个文件反而会让你困惑所以我个人更建议老老实实把端口写进命令里短一点而已换来的是永远不产生歧义。4.3 修改配置文件后如何生效my.ini 不是改完就立刻生效的你需要重启对应的服务。改配置的顺序我建议这样改之前先确认自己改的是哪个版本的 my.ini别把 5.7 的 port 改成 3307 之后顺手把 8.0 的也改成一样了。改完执行net stop MySQL80 net start MySQL80或者一条命令重启在较新 Windows 上支持net stop MySQL80 net start MySQL80如果改的是端口重启后记得用 netstat 再看一下是不是真的换到新端口了。如果改的是 basedir 或 datadir 这种关键路径最好全量net stop两个服务再重新启动避免 Windows 服务管理器缓存旧的路径。还有一类很常见的坑是我见过不少同事踩的改了 my.ini 里的max_connections或者innodb_buffer_pool_size服务也重启了但看起来没生效。原因往往是系统里存在多个 my.inimysqld 读到的是另一个地方的配置。所以我在前面的过程中一直强调用--defaults-file显式指定配置文件这样做的好处就在这里——只要你的服务注册命令里带了 defaults-filemysqld 就只认这一个文件不存在“读到别的配置”的问题。5. 遇到过的坑与排查方法5.1 端口冲突怎么查最常见的报错长这样在日志里能看到[ERROR] Do you already have another mysqld server running on port: 3306 ?或者启动时直接退回命令行服务状态变成“已停止”。这时候不要急着反复点启动先查端口到底被谁占了netstat -ano | findstr :3306看输出里 PID 那一列然后tasklist | findstr 对应的PID根据进程名就能判断是另一个 MySQL 还在跑还是某些中间件把 3306 占了。处理办法很简单要么停掉占用方要么把新实例的端口改掉改完重启。如果是两个 MySQL 服务自己冲突了多半就是你想把两个服务都设在 3306 上。回到第 2 节那张规划表端口不重叠这类问题根本不会出现。5.2 服务启动失败看日志服务启动失败时Windows 给的信息只有“服务启动失败”看不到具体原因。真正的线索在数据目录下那个 .err 文件里比如D:\mysql\mysql-8.0\data\xxx.err打开这个文件拉到最下面看最后几十行。常见的启动失败原因有几个。一个是 basedir 或 datadir 路径写错日志里会明确说找不到某个目录。一个是缺少运行库提示无法加载 xxx.dll。还有一个是 my.ini 编码问题如果文件是用记事本另存为 UTF-8 带 BOM 的格式mysqld 解析的时候会把 BOM 字符当成配置内容然后报错。用 Notepad 或 VS Code 把 my.ini 转成不带 BOM 的 UTF-8 就能解决。还有一种比较隐蔽你手动在前台跑 mysqld --console 能起来但注册成服务后起不来。这种情况多半是服务注册时用的路径是相对路径或者 defaults-file 没写对。解决办法就是把注册命令重新执行一遍所有路径都写成绝对路径并且加上双引号。5.3 初始化报错与权限问题初始化阶段最常见的报错是[ERROR] --initialize specified but the data directory has files in it. Aborting.这就是我前面说的 data 目录非空问题。在初始化前把 data 目录清空或者直接不建 data 目录让 mysqld 自己创建都可以解决。还有一类权限问题很气人注册服务时提示“Install/Remove of the Service Denied”。这说明你当前命令行没有管理员权限。Windows 上注册服务、启停服务都要管理员权限右键“以管理员身份运行”再试。我遇到过最诡异的一次是明明加了--defaults-file但 init 的时候还是报找不到 my.ini。后来发现是路径里带着中文目录名加上命令行编码问题导致路径解析失败。所以建议把 MySQL 的安装路径全部用英文字符别放 C:\用户\张三\ 这种中文路径下省掉很多不必要的坑。5.4 字符集乱码问题两个版本一起用字符集问题基本都会在“数据导入导出”或者“程序连接”的时候跳出来。如果你从 5.7 导出的数据导入 8.0表里的汉字乱码了先别怀疑数据坏了大概率是连接字符集没配对。连接 8.0 后执行SET NAMES utf8mb4;然后再查数据。同时在两个版本的 my.ini 里我都建议把character-set-serverutf8mb4和[client]下的default-character-setutf8mb4写进去这样无论是命令行还是程序连接默认字符集都是 utf8mb4跟现代应用保持一致。还有一个跟版本有关的老问题是认证插件。8.0 默认的认证插件是 caching_sha2_password老版本客户端或者老驱动可能不认识连接时报Authentication plugin caching_sha2_password cannot be loaded如果你遇到这个问题要么把客户端驱动升级到新版本要么在 8.0 里把对应账号改成 mysql_native_passwordALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;这个操作不影响 5.7 实例因为它们是两套独立的用户体系。6. 从一次救急到长期方案按这套流程配完之后我现在的习惯是这样的8.0 常驻服务开机自启5.7 设为手动启动只有切去维护老项目时才 net start MySQL57。两个实例的数据目录、端口、服务名、配置文件全都分开日常开发基本感知不到它们的冲突。配置的过程中有几个小经验值得单独说一说。第一个是--initialize-insecure在开发环境最省心因为初始密码为空可以让你少绕一段“找临时密码”的麻烦。但如果你真要给 8.0 用--initialize不带 insecure初始化完成后数据目录下的 .err 文件会生成一个随机临时密码注意它不是终端输出而在日志里别到处翻。第二个是改任何实例配置之前先net stop再改改完再net start。这听起来像废话但实际操作中真的有人带着正在运行的实例去改 my.ini还反问我为什么没有立即生效。第三个是我个人用下来的体会——把规划表贴在项目文档最前面。双实例方案本身不复杂但时隔三个月后你很可能忘了 5.7 的端口是多少、服务名叫什么重新翻一遍排查过程又费时间。有这张表在后面任何人接手这台机器、接手这个开发环境都能一眼看懂目录里为什么有两个 mysql 文件夹。如果哪天你发现两个实例之间的数据要互相导不要想着在同一台机器上直接跨实例迁移库老老实实 mysqldump 导出再导入端口指向不同实例即可。这是最稳、最不产生幻觉的方式。这套方案到目前为止我帮身边不少人处理过没有一次出过大问题。核心就是记住一句话端口、服务名、数据目录三者互不重叠Windows 上同时跑两个 MySQL 版本真的没有想象中那么难。