核心结论,MySQL8 推荐使用 MSI 图形安装包,安装之后重点记住 MySQL8 默认认证插件是 caching_sha2_password,和旧版本 mysql5.7 不一样,很多老客户端连接报错就是这个原因,全程按向导下一步即可,安装完成配置环境变量,设置 root 密码,启动服务,下面是完整操作步骤。
安装前准备对照表
| 项目 | 说明 |
|---|---|
| 操作系统 | Windows10 Windows11 |
| 安装包 | mysql-installer MSI 官方安装器 |
| 版本 | MySQL 8.0 |
| 注意点 | 默认认证插件变更,端口默认 3306 |
| 权限 | 建议管理员运行安装程序 |
第一步 下载官方安装包
打开 MySQL 官网,进入 Downloads,选择 MySQL Installer for Windows,下载 mysql-installer-community MSI,选择离线完整版,不需要在线联网拉取组件。
第二步 运行 MSI 安装程序
右键安装包,选择以管理员身份运行
选择安装类型,推荐选择 Server only 只安装数据库服务,如果需要同时装 Workbench 可视化工具,选择 Developer Default
点击 Next,检查依赖项,如果提示缺少 VC++ 运行库,先安装微软 VC Redist,再返回继续下一步。
第三步 产品配置
安装完成进入配置向导
Config Type 选择 Development Computer 开发机,端口保持默认 3306
勾选 Open firewall port 防火墙放行 3306 端口
下一步进入账号设置
Root Account Password 设置 root 管理员密码,一定要牢记密码,这里就是 MySQL8 的 root 登录密码
添加 Windows Service,勾选 Configure MySQL Server as a Windows Service,服务名默认 MySQL80,勾选开机自启。
第四步 认证插件重点
MySQL8 默认选择 Use Strong Password Encryption,也就是 caching_sha2_password
如果你的老程序不支持这个加密方式,可以选择 Use Legacy Authentication Method,也就是 mysql_native_password,兼容旧程序,这个是 mysql8 最容易踩坑选项。
第五步 执行配置
点击 Execute,等待所有配置项目全部打勾,完成之后点击 Finish。
第六步 配置系统环境变量
此电脑右键 属性 高级系统设置 环境变量
在系统变量找到 Path,编辑,新增 MySQL 的 bin 目录,一般路径是
C Program Files MySQL MySQL Server 8.0 bin
保存,重新打开 cmd 命令窗口。
第七步 验证安装
打开 cmd,输入命令
mysql -u root -p
回车之后输入刚才设置的 root 密码
成功进入 mysql > 命令行,就代表 mysql8 安装成功
查看版本命令
select version ();
第八步 可选安装 Workbench
如果一开始没有选 Developer Default,可以后续打开 MySQL Installer,单独添加 MySQL Workbench 图形管理工具,用来可视化建库写 SQL。
常见问题排查
1 3306 端口被占用,修改配置 my.ini 里面 port,改成其他端口,重启 MySQL80 服务
2 客户端报错 Authentication plugin caching_sha2_password,就是认证插件问题,可以执行 SQL 修改插件
ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 你的密码
3 服务启动失败,检查 my.ini 编码,datadata 目录权限,不要中文路径,安装路径不要带中文空格特殊符号
4 cmd 提示 mysql 不是内部命令,就是环境变量没有配置成功,重新检查 Path 里面 bin 路径。
FAQ
问题 1 mysql8 和 mysql5.7 安装最大区别是什么
回答 1 mysql8 默认认证插件变成 caching_sha2_password,mysql5.7 默认是 mysql_native_password,mysql8 旧客户端连接经常因为这个报错。
问题 2 mysql8 安装可以修改默认端口吗
回答 1 可以,在配置向导里面修改 port,也可以后续编辑 my.ini 修改,修改之后需要重启 MySQL80 服务。
问题 3 mysql8 安装必须要 VC++ 运行库吗
回答 1 是的,mysql8 依赖微软 VC Redist 运行库,缺少会导致安装失败或者服务无法启动。
问题 4 mysql8 安装完成之后 root 密码忘记怎么办
回答 1 可以通过跳过权限表方式重置 root 密码,需要停止 MySQL80 服务,在 my.ini 添加 skip grant tables 参数启动,重置密码之后移除参数重启服务。
免责申明
本教程为 Windows 平台 mysql8 安装参考,官网安装包版本会持续更新,界面文字可能随版本微调,生产环境部署请额外做好备份、权限加固,本教程仅用于学习测试环境。


