MySQL 8.0跨平台安装与排错：初始化、字符集、认证插件、服务注册

项目标题写的是"详细步骤含截图"，但真正装过几次的人都知道，安装向导的界面每隔几个小版本就会调整一下，去年的截图今年可能就对不上了。所以下面我不打算给你一堆会过期的图，而是把每个界面里你必须核对的那几个字段、每个配置文件里必须出现的那几行拎出来，界面怎么变，你对着字段名找就行。这篇覆盖 Windows、Linux、macOS 三套主流环境的 mysql 安装详细步骤，从版本选型、安装包形态、初始化、服务注册，到首次登录后的必做配置和连不上时的排查顺序，一条线走完。零基础能照着抄，装过几次但总在字符集、认证插件、服务注册上翻车的人，应该能在这里找到那几处一直没搞明白的地方。

1. 动手之前先把这几个选择做完

绝大多数安装失败的案例，根源不在安装过程，而在按下"下一步"之前没想清楚三件事：装哪个版本、用哪种安装包形态、数据目录放哪。这三个决定一旦定错，后面要么重装，要么花两小时改配置。

1.1 版本与安装包形态的选择逻辑

先说版本。目前主流是 8.0 和 5.7 两条线，5.7 已经停止维护，新项目没有理由再选它。8.0 相比 5.7 有几个会直接影响你操作的差异：默认认证插件从mysql_native_password换成了caching_sha2_password，默认字符集从latin1换成了utf8mb4，GRANT语句不再能顺带创建用户，mysql.user表里的password字段被删掉了。这些差异在老教程里全是坑，看到"8.0 之后这样写会报错"，基本都是这几处。

安装包形态的选择更实际，我按使用场景列个对照：

我的建议很直接：Windows 本地开发用 MSI，需要装两个版本做兼容测试用 ZIP；Linux 服务器一律走官方仓库或二进制包，别用系统自带的老版本，尤其是一些发行版仓库里还躺着 5.7 甚至 5.6。

1.2 路径、端口与字符集的提前规划

路径这件事，Windows 上我见过太多人把 MySQL 装在中文路径或者带空格的目录下，然后在初始化时被mysqld: Can't change dir to ...卡住。规矩很简单：安装目录和数据目录只用英文、数字、下划线，不要空格，不要中文。默认路径是安装目录C:\Program Files\MySQL\MySQL Server 8.0，数据目录在C:\ProgramData\MySQL\MySQL Server 8.0\Data——注意ProgramData是隐藏目录，资源管理器里要开"显示隐藏项目"才看得到，很多人以为数据没生成，其实是被藏起来了。

端口默认 3306，8.0 还会额外占用 33060 作为 X Protocol 端口。同一台机器要跑多个实例，就按 3307、3308 往上排，每个实例的datadir、port、socket（Linux）三样都要分开，只改端口不改数据目录，第二个实例起不来。

字符集在 8.0 上基本不用操心，默认就是utf8mb4。但如果你要从 5.7 迁移，或者装的是旧版本，务必在初始化前就定好character-set-server=utf8mb4，因为utf8mb4和utf8（其实是utf8mb3）在索引长度、排序规则上不一样，后期改表结构能把人折腾疯。

还有一个容易被忽略的：lower_case_table_names只能在初始化时指定。Windows 默认是 1（表名转小写存储），Linux 默认是 0（区分大小写）。这个值在初始化之后再改，8.0 会直接启动失败，因为数据字典里的表名大小写和参数对不上。所以如果你是从 Windows 迁移到 Linux，或者反过来，务必在mysqld --initialize之前就把这个参数写进配置文件。

2. Windows 上两条安装路线：向导式与解压式

Windows 是安装问题最集中的平台，因为图形向导的选项多，而且不少选项的默认值并不适合开发场景。下面把 MSI 和 ZIP 两条路都走一遍。

2.1 MSI 向导里真正需要你动手的四个界面

下载mysql-installer-community-8.0.xx.msi，双击后前面几步都是许可协议和安装类型选择。安装类型界面有 Developer Default、Server only、Client only、Full、Custom 五个选项，选 Custom 或者 Server only，Developer Default 会顺带把示例库、Excel 插件、各种连接器一起装上，装完你会发现开始菜单多了一堆东西。

Custom 里只勾MySQL Server和MySQL Shell（后者是可选的命令行客户端，比自带的mysql命令好用一些）。点下一步，会进到 Configuration 阶段，这四块是你必须动手的：

第一块，Type and Networking。Config Type 选 Development Computer，它会按开发机内存给一个保守的内存占用；Port 保持 3306，X Protocol Port 保持 33060；下面有个Open Windows Firewall ports for network access的勾选框，只在本机连的话可以取消，要给别人连就勾上。

第二块，Authentication Method。两个选项：Use Strong Password Encryption（对应caching_sha2_password）和Use Legacy Authentication Method（对应mysql_native_password）。这里我给的建议是选强加密，因为现在主流语言的驱动都支持了。如果你的项目里有很老的客户端、老版本的 Navicat 或者某些嵌入式工具，连上来会报Authentication plugin 'caching_sha2_password' cannot be loaded，那时候再单独给某个账号改成mysql_native_password就行，不需要整个实例降级。

第三块，Accounts and Roles。设 root 密码，建议用不超过 32 位的强密码，别用root、123456，因为 8.0 默认装了validate_password组件，弱密码会直接被拒。下面有个 Add User 区域，可以顺手建一个日常用的账号，日常开发别拿 root 连，这个习惯越早养成越好。

第四块，Windows Service。服务名默认MySQL80，勾上Start the MySQL Server at System Startup，这样开机自启。服务名要记住，后面启动停止都靠它，net start MySQL80、net stop MySQL80。

点 Execute 之后进度条跑完，如果哪怕有一项是红叉，下面的 Log 标签页里会有具体原因。最常见的红色项是端口被占用，日志里会写Port 3306 is already in use，这时候先确认是不是之前装过没卸干净。

2.2 ZIP 包手动初始化：my.ini 与临时密码

ZIP 版没有向导，好处是你知道每一步都发生了什么。解压到D:\mysql-8.0.36-winx64这样干净的路径，然后在根目录下新建my.ini，内容如下：

[mysqld] basedir=D:\mysql-8.0.36-winx64 datadir=D:\mysql-8.0.36-winx64\data port=3306 character-set-server=utf8mb4 collation-server=utf8mb4_0900_ai_ci default-time-zone='+08:00' max_connections=200 [client] port=3306 default-character-set=utf8mb4

几个参数的必要性说明一下。basedir和datadir必须写绝对路径，反斜杠在 ini 里可以直接用；default-time-zone不写的话，NOW()返回的是 UTC，做业务的人会在时间字段上撞墙；max_connections默认 151，本地开发够用，压测时记得调。

datadir指向的目录绝对不要手动创建。这是 ZIP 安装最经典的一个坑：8.0 的--initialize要求目标数据目录不存在或者为空，如果你先建了个空的data文件夹，初始化能过；但如果你建了之后往里放过东西，哪怕是一个.gitkeep，就会报--initialize specified but the data directory has files in it. Aborting.。最省事的做法是配置文件里写好datadir，目录由初始化程序自己创建。

然后以管理员身份打开命令提示符，切到 bin 目录执行：

mysqld --defaults-file=D:\mysql-8.0.36-winx64\my.ini --initialize --console

--console的作用是把日志打到屏幕上，不然你看不到临时密码。输出里会有这么一行：

[Note] A temporary password is generated for root@localhost: kR8!aQ2vzLp=

这串临时密码要立刻复制出来，它是唯一一次显示，关掉窗口就找不回来了，只能删掉 data 目录重新初始化。

2.3 环境变量与服务注册的收尾工作

初始化完成后，注册系统服务：

mysqld --install MySQL80 --defaults-file=D:\mysql-8.0.36-winx64\my.ini net start MySQL80

如果提示The service already exists，说明之前装过，先sc delete MySQL80删掉再装。注意sc delete之后服务列表不会立刻消失，需要刷新或者重开服务管理器。

环境变量这一步别省。把D:\mysql-8.0.36-winx64\bin加进系统变量Path，加完之后新开一个命令行窗口才生效，老窗口读的是启动时的环境变量快照。验证方式是随便一个目录下执行mysql --version，能打出版本号就对了。

第一次登录用临时密码：

mysql -u root -p

登进去之后第一件事是改密码，不改的话除了改密码什么都不能干：

ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码'; FLUSH PRIVILEGES;

3. Linux 下从包管理器到二进制部署

Linux 上装 MySQL 的路线比 Windows 多，选错了后面维护成本差别很大。

3.1 用系统仓库安装：一条命令之后的隐性问题

Debian/Ubuntu 系：

sudo apt update sudo apt install mysql-server sudo systemctl status mysql

装完通常服务已经起来了，但有一个非常反直觉的点：Ubuntu 下 root 账号默认用的是auth_socket插件，也就是它校验的是当前系统的登录用户，不是密码。所以你直接mysql -u root -p输密码是登不进去的，会报Access denied。正确的进入方式是：

sudo mysql

以系统 root 身份进去之后，把认证方式改成密码：

ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY '你的密码'; FLUSH PRIVILEGES;

改完之后sudo mysql反而登不进去了，得用mysql -u root -p，这个切换过程很多人会懵一下。

RHEL/CentOS 系的情况不太一样，仓库里给的可能是mariadb-server而不是 MySQL，两者命令兼容但行为有差异，尤其是mysql_secure_installation的交互项和systemctl服务名（mysqldvsmariadb）。确认版本用：

mysql --version

输出里如果带MariaDB，那装的就是分支版本，配置路径在/etc/my.cnf.d/下面。

系统仓库的另一个问题是版本老。想锁定具体小版本、或者需要 8.0 的新特性，就得走官方仓库。以 apt 为例，流程是：下载官方的mysql-apt-config包、dpkg -i安装、在交互界面里选版本、apt update，然后正常apt install mysql-server。这个交互界面里选错版本是常见翻车点，装完发现版本不对，得先apt purge清干净再重来。

3.2 二进制包部署：用户、目录与 systemd 单元

二进制包适合需要精确控制版本或者跑多实例的场景。以mysql-8.0.36-linux-glibc2.28-x86_64.tar.xz为例：

# 1. 建运行用户，不要用 root 跑 mysqld sudo useradd -r -s /bin/false mysql # 2. 解压并做软链 sudo tar -xf mysql-8.0.36-linux-glibc2.28-x86_64.tar.xz -C /usr/local/ sudo ln -s /usr/local/mysql-8.0.36-linux-glibc2.28-x86_64 /usr/local/mysql # 3. 补依赖，8.0 需要 libaio 和 numactl sudo apt install -y libaio1 libnuma1

依赖这一步是二进制包部署最常见的失败点，缺libaio.so.1的话mysqld会直接报error while loading shared libraries，而且报错信息不会明说缺哪个包。用ldd /usr/local/mysql/bin/mysqld | grep "not found"能一次列出所有缺失的动态库。

配置文件/etc/my.cnf：

[mysqld] user=mysql basedir=/usr/local/mysql datadir=/usr/local/mysql/data socket=/tmp/mysql.sock port=3306 character-set-server=utf8mb4 default-time-zone='+08:00' log-error=/usr/local/mysql/data/error.log pid-file=/usr/local/mysql/data/mysqld.pid

初始化：

sudo /usr/local/mysql/bin/mysqld --initialize --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data

临时密码在error.log里，用grep 'temporary password' /usr/local/mysql/data/error.log捞出来。

systemd 单元文件/etc/systemd/system/mysqld.service：

[Unit] Description=MySQL Server After=network.target [Service] User=mysql Group=mysql ExecStart=/usr/local/mysql/bin/mysqld --defaults-file=/etc/my.cnf LimitNOFILE=65535 Restart=on-failure [Install] WantedBy=multi-user.target

LimitNOFILE=65535这行别漏，默认的文件描述符上限在某些发行版上是 1024，连接数一多就报Too many open files。执行systemctl daemon-reload && systemctl enable --now mysqld之后，用systemctl status mysqld确认状态是 active。

3.3 官方仓库方式与版本锁定

如果走的是官方 apt/yum 仓库，装完建议做一次版本锁定，避免哪天不小心apt upgrade把 MySQL 连带着升上去，大版本内的升级一般没事，但跨小版本的默认参数变化有时会让服务起不来：

sudo apt-mark hold mysql-server mysql-client mysql-community-server

要升级的时候先apt-mark unhold，升级完再 hold 回去。这个操作在生产环境几乎是必做的，我见过不止一次因为自动升级导致字符集默认值变化、老表出现排序规则冲突的情况。

4. macOS 上的 DMG 与 Homebrew 两条路

macOS 上装 MySQL 的阻力主要在权限和路径上，尤其是苹果芯片机型。

4.1 DMG 安装包的流程要点

DMG 包双击之后是标准的 pkg 流程，一路下一步，中间会有一个界面让你设置 root 密码，还有一个是否允许通过本地网络访问的选项。装完之后 MySQL 的默认安装路径是/usr/local/mysql，数据目录在同级的data下。

关键的一步是把/usr/local/mysql/bin加进 PATH。macOS 从某个版本之后默认 shell 换成了 zsh，配置文件是~/.zshrc而不是~/.bash_profile，很多人改错文件，source完还是提示command not found：

echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

DMG 方式安装的 MySQL 会在系统偏好设置里加一个面板，可以图形化启停服务，这个对偶尔用一下的人比较友好。但它有个小问题：面板里的启动和命令行的mysql.server start是两套入口，有时候面板显示已启动，命令行却连不上，这时候看/usr/local/mysql/data/*.err里的错误日志比点什么按钮都管用。

4.2 Homebrew 方式与 M 系列芯片的路径差异

开发者日常我更推荐 Homebrew：

brew install mysql brew services start mysql mysql_secure_installation

brew services start会把它注册成用户级后台服务，开机自启。相比 DMG，Homebrew 的好处是升级和卸载都干净：brew uninstall mysql基本能清掉，不像 DMG 还得手动翻/usr/local和/Library/LaunchDaemons。

苹果芯片机型要注意路径分叉：Homebrew 在 arm64 上装在/opt/homebrew，在 Intel 上装在/usr/local。如果你按某篇老教程往 PATH 里加了/usr/local/opt/mysql/bin，在 M 系列机型上会找不到东西，正确路径是/opt/homebrew/opt/mysql/bin。用brew --prefix mysql能直接问出真实路径，这比背路径靠谱。

还有一个坑：brew install mysql装的是最新稳定版，如果你需要老版本，得走brew install mysql@5.7这种形式，装完之后命令名不带版本号，但实际调用需要指定路径，brew link也可能因为多个版本并存而失败，这时候用完整路径调用更稳妥。

5. 第一次登录之后必须立刻做的五件事

装完能登进去不等于装完了。默认配置是给"能跑起来"设计的，不是给"能用得下去"设计的，下面这几件事没做，后面大概率会在某个时间点被绊一下。

5.1 改 root 密码与密码策略组件的取舍

改密码前面已经写了。这里补充两个细节。

第一，validate_password组件在官方安装包里默认是开启的，要求密码长度、大小写、数字、特殊字符至少满足若干项。如果你是在本地开发机，觉得每次都要凑一个复杂密码很烦，可以调低策略：

SET GLOBAL validate_password.policy = LOW; SET GLOBAL validate_password.length = 6;

注意这是SET GLOBAL，重启就失效。要持久化就得写进my.cnf的[mysqld]段。但生产环境别关这个组件，宁可麻烦一点。

第二，8.0 之后GRANT不能再顺带创建用户了。老教程里写GRANT ALL ON *.* TO 'test'@'%' IDENTIFIED BY 'pwd';在 8.0 上会直接语法报错，必须先CREATE USER再GRANT：

CREATE USER 'appuser'@'%' IDENTIFIED BY 'StrongPwd@2024'; GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO 'appuser'@'%'; FLUSH PRIVILEGES;

权限给到具体的库和具体的操作类型就行，别图省事直接ALL PRIVILEGES ON *.*，这是后面出事故的常见源头。

5.2 字符集、时区与 lower_case_table_names 的初始化时机

字符集验证：

SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%';

character_set_server和character_set_database都应该是utf8mb4。如果是latin1，说明配置文件没生效，检查my.ini/my.cnf是不是放在了正确位置——Windows 下my.ini必须在basedir根目录，Linux 下优先级是/etc/my.cnf>/etc/mysql/my.cnf>$basedir/my.cnf，放错地方参数就白写了。

时区验证：

SELECT @@global.time_zone, @@session.time_zone, NOW();

如果前两个都是SYSTEM而NOW()比你的本地时间差 8 小时，说明系统时区没配对，这时候直接在配置里写死default-time-zone='+08:00'最快，别去折腾系统的/etc/localtime。

lower_case_table_names再强调一遍，SHOW VARIABLES LIKE 'lower_case_table_names';查出来是几就是几，初始化之后改不了。真需要改，唯一路径是备份数据、停服务、删datadir、改配置、重新初始化、导回数据。所以如果你有跨平台迁移的打算，初始化之前就把这个值定成目标平台的值。

第一个业务库建好之后，再验证一次排序规则：

CREATE DATABASE demo_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci; SHOW CREATE DATABASE demo_db;

utf8mb4_0900_ai_ci是 8.0 的默认排序规则，是基于 Unicode 9.0 的，和 5.7 的utf8mb4_general_ci在排序结果上会有细微差别，业务里有按字符串排序的需求时值得留意。

6. 客户端连不上时的排查顺序

Can't connect to MySQL server这个报错几乎每个装 MySQL 的人都见过，它背后可能是五六种完全不同的原因。下面这套顺序是我自己按"从便宜到贵"排的，按这个链路走基本能在五分钟内定位。

6.1 从服务状态到端口占用的逐层验证

第一层，服务是不是真的在跑。

Windows：

sc query MySQL80

看STATE是不是RUNNING。如果显示STOPPED，先试着net start MySQL80，启动失败的话去datadir下找.err结尾的错误日志，最后几十行一定有原因。

Linux：

systemctl status mysqld

状态是failed的话，journalctl -u mysqld -n 50能看到最近的启动日志。

第二层，端口在不在监听。

# Linux/macOS ss -lntp | grep 3306 # Windows netstat -ano | findstr :3306

没有输出说明服务没起来，或者配置里port改成了别的值、skip-networking被打开了。有输出但地址是127.0.0.1:3306而不是0.0.0.0:3306，说明只监听本地，远程连不上是正常的，改my.cnf里的bind-address = 0.0.0.0或者注释掉这一行。

第三层，账号的 host 匹配。MySQL 的权限是按用户名@主机组合来的，'root'@'localhost'和'root'@'%'是两个完全不同的账号。本机用localhost连走的是 socket 或者 127.0.0.1，远程连走的是%那条记录。查一下到底有哪些账号：

SELECT user, host, plugin FROM mysql.user;

没有%的记录，就得建一个。

第四层，防火墙。Windows 上 MSI 安装时如果没勾"开放防火墙端口"，外部连进来会被拦。Linux 上firewalld或者ufw同理。这一层最容易误判，因为服务、端口、账号全对，就是连不上，用telnet 服务器IP 3306一试就能区分是网络层还是数据库层的问题。

6.2 认证插件引发的连接失败

8.0 换成caching_sha2_password之后，一类新的报错开始频繁出现：

Authentication plugin 'caching_sha2_password' cannot be loaded

这不是密码错了，是客户端不认这个插件。判断方法很简单，看报错里的关键词是cannot be loaded还是Access denied，前者是插件问题，后者才是密码问题。

临时解决方案是给这个账号单独换成老插件：

ALTER USER 'appuser'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;

但这是治标。mysql_native_password在 8.0 里已经是废弃状态，长期看应该升级客户端驱动。有些语言的驱动通过连接串参数可以指定认证方式，比改数据库账号更安全。

另一类容易混淆的报错是ERROR 2059 (HY000): Authentication plugin 'caching_sha2_password' cannot be loaded: dlopen(...)，出现在命令行客户端上，说明客户端版本比服务端老，直接用安装目录里自带的新版mysql客户端就好。

6.3 常见报错对照表

这张表建议收藏，我见过的问题九成都在里面。

7. 卸载不干净导致的重复安装失败

"我明明卸载了，为什么重装还是报错"，这个现象在 Windows 上尤其常见。原因是卸载程序只删了安装目录，数据目录、注册表项、服务注册都还在。

7.1 Windows 下的残留清理清单

卸载之后按这个顺序清：

1. C:\ProgramData\MySQL整个目录删掉，这是数据目录，卸载程序默认不动它；
2. C:\Program Files\MySQL如果还在也删掉；
3. 管理员命令行执行sc query MySQL80，如果服务还在，sc delete MySQL80；
4. 注册表HKEY_LOCAL_MACHINE\SOFTWARE\MySQL AB删除（操作注册表前先导出备份）；
5. 环境变量Path里残留的 MySQL bin 路径去掉。

清理完重启一次再装，不然服务句柄可能还没释放。这套流程我走过不止一次，跳过任何一步都可能在新装的时候撞上Port 3306 is already in use或者The service already exists。

7.2 Linux 与 macOS 的清理差异

Linux 用包管理器装的话，apt purge mysql-server mysql-client mysql-common mysql-community-server能清掉大部分，但/var/lib/mysql（数据目录）和/etc/mysql（配置目录）通常会保留，需要手动删。这三个目录不清，重装之后会读到你之前改过的旧配置，出现"新装的实例行为跟以前一样"的诡异现象。

macOS 上 Homebrew 装的最省事，brew uninstall mysql && brew cleanup基本就干净了，数据目录/opt/homebrew/var/mysql或/usr/local/var/mysql会保留，需要的话手动删。DMG 装的麻烦一些，除了/usr/local/mysql，还要检查/Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist这个自启项和系统偏好设置里的面板，顺序上先停服务、再删 plist、最后删目录。

最后说一个我自己的习惯：每次装完 MySQL，把SHOW VARIABLES的关键几项和版本号截下来存到一个文本文件里，尤其是有多台机器或者多套环境的时候。等到某天某台机器上的行为和其他机器不一致，翻出这份快照一比，差异立刻现形，比在配置文件里逐行找快得多。安装这件事本身半小时能搞定，真正花时间的是装完之后那些"为什么这台可以那台不行"的对照，把基准数据留好，后面能省下大把时间。