MySQL 8.4.6 安装配置实战：从选型下载到避坑排查全指南

简介面向 Windows 初学者的 MySQL 8.4.6 安装配置教程项目以源码包形式承载完整操作指引适合开发人员、系统管理员以及刚接触数据库的新手重点解决从官网下载、版本选择、安装配置到命令行连通性验证的全流程困惑。资源共 3 个文件HTML 教程页面为主体.inscode 文件用于在线运行环境配置.gitignore 提供版本控制支持压缩包整体仅 5KB体积小巧但流程完整。目前已有 88 人学习下载。内容涵盖官网下载、MSI 安装器基本版与网络版的差异判断、自定义安装、数据存储目录规划、root 密码安全设置、bin 目录环境变量配置和命令行连接测试并针对版本误选、密码策略不理解、命令无法识别等易错点做了说明。读者可对照页面逐步操作安装结束后能回看关键环节用于排错既可作为首次安装向导也可作为日常配置速查参考。1. 为什么 MySQL 8.4.6 安装配置一眼看过去全是坑做 Java 后端或者数据类项目的朋友应该都经历过类似场景项目代码里依赖 MySQL本地开发环境装的是 5.7CI 服务器上用的是 8.0.x生产环境一查是 8.4.6 LTS。三个环境的认证插件、密码策略、字符集默认值各不相同代码一跑就翻车。MySQL 8.4.6 属于 8.4 LTS 通道里的维护版本修复了一批安全漏洞也是目前很多公司“既想上新版又不愿意当小白鼠”的折中选择。这篇内容直接围绕“下载哪个包、初始化怎么做、项目连接串怎么配置、遇到 2002 和 1820 之类报错怎么排”展开尽量让新手机器能装完就连上库让熟手看到边界参数和玄学现场。2. 选型与拿包为什么不是 9.x也不是 8.0.4x2.1 8.4 LTS 通道与 8.0 系列的关键差异MySQL 从 8.4 开始调整了版本节奏8.4 是 LTS 长期支持版本之后的 9.x 属于 Innovation 创新版本。作为一线实践者我的建议很直白给项目用优先选 LTS别追创新版除非你有专门团队陪跑升级。LTS 意味着安全补丁维护周期更长第三方中间件和驱动适配得更稳定这对生产项目来说比“多几个新功能”重要得多。8.4 和 8.0 系列有个容易踩的细节默认认证插件是caching_sha2_password这个从 8.0 后期开始就是默认值但旧项目里不少人还在用mysql_native_password。8.4 里对 native 密码插件的支持进一步弱化老驱动比如 5.1.x 的 JDBC直连大概率直接拒绝握手。另一个差异是validate_password组件默认生效初始密码规则偏严想设一个简单测试密码会报 ERROR 1819。2.2 从 MySQL 下载官网挑对安装包tar.gz、zip、还是包管理器先说结论Linux 服务器上我一般用官方二进制 tar.gz 包不用 yum/apt 自带的源。原因不复杂——官方包的 glibc 版本明确、目录可控、清理时直接删目录就行系统源里的 MySQL 经常被替换成 MariaDB 或者版本滞后生产环境不想给自己埋雷。Windows 开发机就用官方 zip 绿色版不跑安装向导解压即用方便多版本共存。下载官网页面上的文件名带linux-glibc2.17或glibc2.28之类的标签需要先确认服务器系统 glibc 版本命令是ldd --version。选错 glibc 版本的包mysqld 初始化时会直接报version GLIBC_2.28 not found这是新手最常见的翻车点之一。Windows 端文件名一般带winx64.zip这个一般不分版本只要别下成 debug 版就行。校验文件完整性的步骤不能省。官方镜像站给每个包都附了 MD5 或 SHA256 校验值下载后核对一下再解压能挡掉不少传输损坏和第三方镜像的狸猫换太子问题。wget https://dev.mysql.com/get/Downloads/MySQL-8.4/mysql-8.4.6-linux-glibc2.17-x86_64.tar.xz md5sum mysql-8.4.6-linux-glibc2.17-x86_64.tar.xz # 期望输出应该和官网页面上列出的 MD5 完全一致 tar -xvf mysql-8.4.6-linux-glibc2.17-x86_64.tar.xz -C /usr/local/MD5 校验这条命令的逻辑很朴素对比输出结果与官网给出的值是否一致不一致就重新下载。这里强调一个习惯——不要用-C /直接解压先解压到临时目录再移到目标路径能避免权限错乱。tar.xz 格式比 tar.gz 压缩率高但解压时间长一点属于正常现象。提示MySQL 下载官网最近把下载页改成 Oracle Web 登录后才能下某些包但二进制 tar 包和 zip 包通常可以直接 wget只是路径里需要带具体版本号建议在浏览器下载页用“复制链接地址”拿到真实 URL。2.3 三类安装方式对比和适用场景安装方式适用场景优点坑点官方 tar.gz/zip 二进制包生产服务器、开发机多版本共存目录可控、卸载干净、升级明确需手动初始化、手动配 systemd包管理器yum/apt/dnf只想快速体验、内部测试依赖自动解决、路径固定版本滞后、可能被替换成 MariaDBDocker 镜像mysql:8.4.6本地联调、CI 跑测试环境隔离、起停快数据卷权限、认证插件与宿主不一致这里多说一句 Docker 方案。容器里装的 MySQL 8.4.6 和宿主机直装本质上是同一个二进制但配置文件与数据目录映射容易出问题尤其是权限容器内 mysql 用户 uid 是 999宿主机目录如果属主不是 999启动直接失败。这个只影响容器场景不在本文主线上展开但值得心里有数。3. 安装与初始化从空白服务器到 mysql -uroot 能登录3.1 Linux 二进制包最小安装步骤有了 tar 包之后安装顺序就固定了解压、建系统用户、建数据目录、写 my.cnf、初始化数据目录、启动、设置开机自启。下面这段脚本覆盖了完整流程先复制执行再逐个解释。# 1. 移动解压目录并改名 mv /usr/local/mysql-8.4.6-linux-glibc2.17-x86_64 /usr/local/mysql # 2. 创建 mysql 系统用户用于隔离权限 useradd -r -s /sbin/nologin mysql # 3. 创建数据目录并授权 mkdir -p /data/mysql chown -R mysql:mysql /data/mysql # 4. 初始化数据目录注意这里会产生临时 root 密码 /usr/local/mysql/bin/mysqld --initialize --usermysql --basedir/usr/local/mysql --datadir/data/mysql # 5. 查看初始密码 grep temporary password /data/mysql/error.log初始化这一步是所有新手绕不过去的分水岭。--initialize会生成一个全新的数据目录里面包括系统库mysql、performance_schema等同时为 root 生成随机初始密码写进 error log。如果没有这一步直接启动 mysqld会报错“数据目录为空无法启动”。反过来如果你重复跑两次--initialize第二次会说数据目录非空——我第一次装 8.0 时就犯过这个错还以为初始化可以覆盖执行。--initialize-insecure是另一个变体生成无密码的 root 账户仅建议在临时测试环境用。生产环境走标准--initialize把临时密码从 error.log 里取出来再做首次修改。初始化完成后真正启动服务还需要一个启动脚本或 systemd unit 文件。手工mysqld_safe启动只适合验证服务器重启后不会自动拉起来。我一般直接写一个 systemd 配置这样systemctl start mysqld和开机自启都解决好。[Unit] DescriptionMySQL 8.4.6 Server Afternetwork.target [Service] Usermysql Groupmysql ExecStart/usr/local/mysql/bin/mysqld ExecStartPre/usr/local/mysql/bin/mysqld --validate-config TimeoutSec180 [Install] WantedBymulti-user.targetsocket路径如果不在默认的/tmp/mysql.sock客户端连接时会报ERROR 2002 (HY000): Cant connect to local MySQL server through socket /tmp/mysql.sock这个我们后面单独展开。ExecStartPre 里的--validate-config是个容易忽略的好习惯如果 my.cnf 里有非法参数unit 拉起时直接失败不会出现服务假死的状态。3.2 Windows 上 zip 包安装不需要安装向导Windows 开发机上最顺滑的方式是下载 zip 包解压后手动注册 Windows 服务。解压到D:\mysql-8.4.6-winx64这样的目录然后手动写一个最小 my.ini。[mysqld] basedirD:/mysql-8.4.6-winx64 datadirD:/mysql-8.4.6-winx64/data port3306 character-set-serverutf8mb4 collation-serverutf8mb4_0900_ai_ci [client] default-character-setutf8mb4注意 Windows 路径里的斜杠用正斜杠反斜杠在某些配置解析场景会出问题。datadir 指向解压目录下的 data 文件夹这个文件夹不需要手动创建初始化命令会自动生成。cd D:\mysql-8.4.6-winx64\bin .\mysqld --initialize-insecure --console .\mysqld --install MySQL84 net start MySQL84--initialize-insecure在这里是可以接受的因为 Windows 开发机通常只需要本地测试root 空密码登录后马上创建业务账号。如果必须用--initialize临时密码同样会写进 data 目录下的.err文件里路径一般在D:\mysql-8.4.6-winx64\data\下文件名和机器名一致后缀是.err。注册 Windows 服务时MySQL84是自定义服务名决定你在服务管理器里看到的名字。若之前装过旧版 MySQL建议服务名区分开比如 MySQL80 和 MySQL84 共存互不影响。卸载服务用.\mysqld --remove MySQL84。3.3 my.cnf 关键参数哪些该调哪些别乱动配置参数这个问题新手容易陷入“抄作业”的误区。实际上生产环境最值得调的就这么几项参数建议值说明innodb_buffer_pool_size物理内存的 60%~70%InnoDB 缓存池性能调优最先看它max_connections按项目并发定默认 151 往往不够连接数上限设太大内存会爆log_bin生产环境建议开启数据恢复和主从复制的后悔药character-set-serverutf8mb4避免中文乱码和表情符号写入失败default-authentication-plugincaching_sha2_password8.4 默认值不要改回 native 除非驱动太旧bind-address127.0.0.1 或内网 IP默认只监听本机远程连不上先查这个[mysqld] user mysql basedir /usr/local/mysql datadir /data/mysql port 3306 socket /tmp/mysql.sock character-set-server utf8mb4 collation-server utf8mb4_0900_ai_ci default-authentication-plugin caching_sha2_password innodb_buffer_pool_size 2G log-error /data/mysql/error.log slow_query_log 1 slow_query_log_file /data/mysql/slow.log long_query_time 2socket路径这里特意写成/tmp/mysql.sock因为有太多客户端工具默认在这个路径找 socket。如果改到别的目录每次 mysql 命令都得手动加-S参数容易翻车。slow_query_log和long_query_time一起开起来是排查项目慢 SQL 的基础设施顺手就配置好别等线上卡了才想起。innodb_buffer_pool_size是 MySQL 性能调优的第一参数。这台机器如果只有 4G 内存设 2G 就偏高了留给 OS 的余量不足会造成 swap 抖动。经验值先取系统内存的 50%线上观察命中率再微调。4. 项目侧连库配置从 root 过度到业务账号4.1 初始化后的第一件事登录并修改 root 密码拿到临时密码后执行下面的命令进入 MySQL 环境。这一步一定要做的原因有两个一是临时密码过期策略默认开启不修改的话操作几次就会被强制下线二是 root 账号权限实在太大项目代码绝不能直连 root。/usr/local/mysql/bin/mysql -uroot -pALTER USER rootlocalhost IDENTIFIED BY YourStr0ng!Pass; FLUSH PRIVILEGES;MySQL 8.4 的默认密码策略是 validate_password 组件生效要求密码至少包含大写、小写、数字、特殊字符长度至少 8 位。如果设的密码不够强会收到ERROR 1819 (HY000): Your password does not satisfy the current policy requirements。开发机想降低规则可以执行SET GLOBAL validate_password.policy LOW;再加SET GLOBAL validate_password.length 6;但生产服务器不建议这么干。“临时密码用一次就丢”是我自己的一个习惯。拿到grep输出后立即登录改密改完把 error.log 里的日志轮转掉避免临时密码留在磁盘上被其他运维同事看到。这不是强迫症是安全习惯。4.2 创建业务账号不直接用 root 连项目项目代码连接 MySQL 时最忌讳直接拿 root 账号。常见做法是给业务单独建账号权限只给够用的库这样即使连接串泄露影响面也可控。CREATE DATABASE IF NOT EXISTS app_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_0900_ai_ci; CREATE USER app_userlocalhost IDENTIFIED BY AppUser!123; CREATE USER app_user% IDENTIFIED BY AppUser!123; GRANT ALL PRIVILEGES ON app_db.* TO app_userlocalhost; GRANT ALL PRIVILEGES ON app_db.* TO app_user%; FLUSH PRIVILEGES;这里的%表示允许任意主机远程连接如果项目应用和数据库在同一台机器只保留localhost就够。远程连接授权这一步是 Navicat/Workbench 连不上的常见原因排查顺序是先看账号 host 是否覆盖来源 IP再看 bind-address最后查防火墙。GRANT ALL PRIVILEGES ON app_db.*的含义是只对 app_db 这一个库授予全部权限*.*则代表所有库——除非你是 DBA 角色否则不要给业务账号*.*权限。最小化授权在生产上是铁律。4.3 JDBC 连接串与 Workbench 连接参数项目代码接入 8.4.6最容易炸的地方是 JDBC 驱动版本和连接串参数。5.1.x 版本的老驱动直接连 8.4 大概率报Unable to load authentication plugin caching_sha2_password解决路径是升级驱动到 8.0.33 以上或者 8.4 配套驱动。连接串里的几个参数一并在下面标出来。jdbc.urljdbc:mysql://localhost:3306/app_db?useSSLfalse\ allowPublicKeyRetrievaltrue\ serverTimezoneAsia/Shanghai\ characterEncodingutf8mb4 jdbc.usernameapp_user jdbc.passwordAppUser!123useSSLfalse是关闭 SSL 加密通道本地开发可以这样省去证书配置生产环境建议useSSLtrue并配证书安全性高。allowPublicKeyRetrievaltrue这个参数很多人忽略不设的话连接 8.0 的 caching_sha2 认证会报Public Key Retrieval is not allowed尤其是从老版本 MySQL 迁移过来时最容易遇到。serverTimezone是时区参数不写的话驱动会用 JVM 默认时区可能导致CST和Asia/Shanghai混乱时间字段读写相差 13 个小时的诡异现象就是这么来的。MySQL Workbench 使用教程里连接配置界面同样有个细节容易被跳过默认连接方式选 TCP/IP 时Host 填 localhost 实际走的是 TCP 还是 socket 取决于界面选项。Workbench 连 Linux 服务器上的 MySQL 时如果服务器端 socket 不在默认路径且 bind-address 限制了监听地址界面会报 2002 或 10061 错误。解决办法是 Host 填服务器内网 IP端口填 3306别填 localhost。HikariConfig config new HikariConfig(); config.setJdbcUrl(jdbc:mysql://localhost:3306/app_db?useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai); config.setUsername(app_user); config.setPassword(AppUser!123); config.setMaximumPoolSize(20); config.setMinimumIdle(5);上面的 HikariCP 配置里maximumPoolSize20和 MySQL 的max_connections必须对齐。常见问题应用端配了 200MySQL 默认最大连接数才 151一压测直接报Too many connections。连接池大小按应用线程数估算不是越大越好HikariCP 官方文档里的经验是core size 2 * CPU 核数 磁盘数这个可以作为起点。注意连接池最大连接数不要超过 MySQLmax_connections的 70%留出 DBA 手动维护连接和后台任务的余量否则高峰期一个慢查询就能把连接池打满业务全部卡死。5. 避坑排查5 个让 MySQL 8.4.6 安装配置翻车的典型现场5.1 ERROR 2002socket 文件路径不一致现象执行mysql -uroot -p报错ERROR 2002 (HY000): Cant connect to local MySQL server through socket /tmp/mysql.sock。原因客户端默认去/tmp/mysql.sock找 socket 文件但服务端启动时把 socket 写到了/var/lib/mysql/mysql.sock或socket参数被 my.cnf 改了路径。解决先确认服务确实在跑ps -ef | grep mysqld再用mysql --socket/var/lib/mysql/mysql.sock -uroot -p登录验证。长期解决是把 my.cnf 里[client]段的 socket 路径与服务端统一或者用 TCP 方式连接mysql -h127.0.0.1 -P3306 -uroot -p。这里有个隐藏细节-hlocalhost和-h127.0.0.1对 MySQL 客户端而言语义不同前者走 socket后者走 TCP。5.2 Access deniedroot 密码和 host 不匹配现象输入正确密码仍然报ERROR 1045 (28000): Access denied for user rootlocalhost。原因MySQL 的账号是“用户名 host”组合判断的。rootlocalhost和root127.0.0.1是两个不同的账号。如果初始化时 root 只有 localhost用-h127.0.0.1连接就走 IPv4 回环匹配不到账号。解决统一用mysql -uroot -p走 socket 登录或者创建root127.0.0.1账号。另外一种情况是密码确实忘干净了这时只能走skip-grant-tables弱恢复流程[mysqld] skip-grant-tablessystemctl restart mysqld mysql -uroot ALTER USER rootlocalhost IDENTIFIED BY NewStr0ng!Pass;重启前记得把skip-grant-tables从配置里删掉否则 MySQL 会一直处于不校验密码状态这是一种比门没锁还危险的裸奔状态。这个方案是真正意义上的后悔药但只允许在单机维护窗口使用任何暴露在网络的服务器开着 skip-grant-tables 就等于被人直接进家门。5.3 ERROR 1820 / 1819密码策略导致初始化失败现象登录后执行任意业务 SQL 报ERROR 1820 (HY000): You must reset your password using ALTER USER statement before executing this statement.或者设新密码时报 1819 不满足策略。原因8.4.6 初始化时默认把 root 的密码设为 expired 状态首次登录后必须先改密才能操作validate_password组件的默认策略是 MEDIUM弱密码直接拒绝。解决老老实实先改 root 密码再创建业务账号。如果测试环境确实需要弱密码临时策略调整如下SET GLOBAL validate_password.policy LOW; SET GLOBAL validate_password.length 6;这两个参数是会话级还是全局级要搞清楚SET GLOBAL只对之后新建的账号生效已存在的账号密码不会自动放宽。这组参数重启后恢复默认需要固化到 my.cnf 里得加validate_password.policyLOW之类的配置项。5.4 JDBC 连接报 Public Key Retrieval is not allowed现象Java 项目启动时连接池报错CachingSha2PasswordPlugin: Public Key Retrieval is not allowed。原因MySQL 8 默认的 caching_sha2_password 认证方式在 SSL 未开启时需要客户端向服务器请求 RSA 公钥来加密传输密码。新版驱动默认不自动获取公钥防止中间人攻击。解决JDBC URL 加上allowPublicKeyRetrievaltrueuseSSLfalse两个参数。这里要解释一下为什么useSSLfalse也救不了即使关掉 SSLcaching_sha2 仍需要公钥协商这个参数就是“允许客户端向服务器要公钥”的开关。生产环境建议反过来开 SSL 并配置证书这样allowPublicKeyRetrieval就不需要了。5.5 远程连接超时或拒绝bind-address、防火墙和 host 授权三连查现象用 Navicat/Workbench 从本机连远程服务器 MySQL报Cant connect to MySQL server on x.x.x.x (10061)或直接超时。原因三层阻碍——MySQL 没监听外网地址、系统防火墙拦截了 3306 端口、账号 host 未包含来源 IP。解决按顺序排查。先看监听地址netstat -tlnp | grep 3306如果只监听127.0.0.1:3306回 my.cnf 把bind-address改成实际内网 IP 或者0.0.0.0再重启。然后检查防火墙CentOS 的 firewalld 和 Ubuntu 的 ufw 命令不同不要记混firewall-cmd --permanent --add-port3306/tcp firewall-cmd --reload # 或 Ubuntu ufw allow 3306/tcp最后确认账号 host。mysql.user表里业务账号的 host 如果是localhost远程就是死路一条改成%或者具体网段。这三层检查完再重新连接90% 的远程连接问题都能解决。6. 用 mysqldump 做定时备份8.4.6 项目上线前最后一道安全网前面把安装、配置、连接、排查全部理顺之后项目真正跑起来之前还欠一道工序备份。MySQL 的崩溃恢复能力再好也防不住一条DELETE FROM table WHERE id 0或者DROP TABLE的手滑。我的习惯是任何项目环境哪怕本地开发机都要在初始化完成后立刻配置一个全量备份脚本每天凌晨跑一次保留最近 7 天这样出任何问题都有后悔药。#!/bin/bash BACKUP_DIR/data/backup/mysql KEEP_DAYS7 DATE$(date %F_%H%M) DB_USERbackup_user DB_PASSBackup!Pass mkdir -p ${BACKUP_DIR} /usr/local/mysql/bin/mysqldump \ --single-transaction \ --set-gtid-purgedOFF \ -u${DB_USER} -p${DB_PASS} \ --databases app_db ${BACKUP_DIR}/app_db_${DATE}.sql find ${BACKUP_DIR} -type f -name *.sql -mtime ${KEEP_DAYS} -delete脚本里的backup_user建议单独创建CREATE USER backup_userlocalhost IDENTIFIED BY Backup!Pass;然后给SELECT, SHOW VIEW, TRIGGER权限即可不需要 SUPER 权限。--single-transaction是 InnoDB 引擎做非锁定备份的关键参数它通过一致性视图导出数据不影响在线业务写。--set-gtid-purgedOFF在 8.4 里尤其重要开启 GTID 的实例如果不加这个参数导出的 SQL 会包含SET GLOBAL.GTID_PURGED语句恢复到其他实例时直接报错。恢复流程也有讲究别急着在生产环境直接导入。先在一台临时实例上建好库再导入确认数据量对得上再指向新库mysql -uroot -p -e CREATE DATABASE app_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_0900_ai_ci mysql -uroot -p app_db /data/backup/mysql/app_db_20240721_0300.sql还原后的数据目录和二进制日志可能与你原来的主从架构不兼容这点在 8.4 上要格外注意。如果项目后续要做主从复制备份策略要改成mysqldump --source-data2或者用xtrabackup级别的一致性快照单纯 mysqldump 的 SQL 备份只能保底不能支撑高可用切换。crontab 里加一行0 2 * * * /usr/local/bin/mysql_backup.sh让脚本每天凌晨 2 点执行然后写个简单的定时任务检查第二天早上看一眼备份文件大小低于 100M 的说明库里数据可能有问题或者连接串错了备份文件直接为空就是认证失败的信号。这套流程跑顺之后MySQL 8.4.6 的安装配置算是真正闭环了装得上、连得上、项目代码跑得通、数据还有得救。我自己这些年迭代出的习惯是——每换一个新版本环境先把备份脚本写好再往上堆业务代码。顺序颠倒过一回恢复数据时看着空空的备份目录那种无助感这辈子不想来第二次。希望这篇文章能帮你把 8.4.6 的部署之路走顺少踩几个我当年踩过的坑。本文还有配套的精品资源点击获取