ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

MySQL 8.0安装配置实战:版本选择、核心参数与排障全攻略

MySQL 8.0安装配置实战:版本选择、核心参数与排障全攻略

MySQL安装这件事,说难不难,说容易也真有不少人栽跟头。我这些年帮同事、朋友处理过太多次MySQL装不上、起不来、连不上的问题,大多数坑其实都集中在版本选择、环境准备、初始化和权限设置这几个环节。这篇就把我从零开始安装配置MySQL的完整流程和踩坑记录整理出来,尽量把每一步为什么这么做讲清楚,照着操作基本一次能过。


1. 安装前先想清楚:版本、环境与安装方式

1.1 版本选择:8.0还是5.7,别选错了

现在新装MySQL,我强烈建议直接上8.0系列。5.7虽然在很多老项目里还在跑,但官方已经停止了更新维护,新环境没必要再从一个即将过时的版本起步。8.0和5.7相比,几个影响日常使用的变化值得提前知道:

  • 默认字符集变成了utf8mb4,建表时不用再手动指定UTF-8,对中文、生僻字和emoji的支持更省心。
  • 身份认证插件默认是caching_sha2_password,比5.7的mysql_native_password安全性更高,但老客户端和旧版驱动可能不兼容,连不上时优先怀疑这个。
  • 8.0支持窗口函数、公用表表达式(CTE)这些现代SQL语法,写复杂查询的时候会舒服很多。

版本号要选稳定版,8.0.3x、8.0.4x这种长期支持的补丁版本是首选。千万不要装那些预览版或创新版,生产环境稳定压倒一切。

1.2 环境准备:硬件、操作系统和依赖

先说硬件。我自己在2核4G内存的云服务器上跑MySQL 8.0完全没问题,日常的小型业务、博客、后台系统都扛得住。如果是核心生产库,建议4核8G起步,磁盘尽量用SSD,顺序读写性能对数据库影响非常明显。

操作系统方面,我这里主要说Linux,因为服务器环境90%都是Linux。CentOS/RHEL系和Ubuntu/Debian系的安装方式有一些区别,下面会分开讲。无论哪个系统,安装前都要先确认几个基础环境:

  • 时间同步要打开,NTP服务开启,数据库对时间敏感,时钟漂移会导致日志和事务时间错乱。
  • 关闭SELinux或者给MySQL放行相关端口,否则可能会出现进程能启动但连接被系统安全策略拦掉的情况。这个在我实际排障中遇到过好几次。
  • 确认没有残留的MySQL或者MariaDB,有些系统镜像预装了MariaDB,端口和命令会冲突,必须先卸载干净。

1.3 安装方式对比:仓库、二进制包还是Docker

安装MySQL的方式我整理了一下,各有利弊:

安装方式优点缺点适用场景
官方Yum/Apt仓库版本可控、升级方便、依赖自动处理需要联网,仓库配置稍麻烦绝大多数Linux服务器
通用Linux二进制包完全不依赖网络,目录可自定需要手动配置服务、依赖库、权限内网隔离环境,定制化部署
系统自带源一条命令就装好版本很旧且不可控本地测试,不推荐生产
Docker容器环境隔离,快速启动数据卷、网络配置要额外学习开发环境、CI/CD,不适合新手做生产

这篇我重点讲官方Yum仓库和二进制包两种方式,因为这两个是最实用、覆盖场景最广的。


2. 安装全流程实录

2.1 CentOS/RHEL系统通过官方仓库安装

先说CentOS/RHEL系。这套流程的核心是:先下载一个包含MySQL软件源信息的RPM包,安装它,这样系统就知道从哪里下载MySQL的各个组件了。

打开MySQL官网的软件源页面,找到这个文件:mysql80-community-release-el7-XXXX.noarch.rpm,其中el7对应CentOS 7,el8对应CentOS 8,el9对应Rocky Linux 9这类新系统。用wget下载到服务器后,执行:

# 安装软件源 rpm -Uvh mysql80-community-release-el8-1.noarch.rpm # 检查源是否生效 yum repolist enabled | grep mysql

看到mysql-community-server那一行就说明源生效了。这里有个坑:如果系统之前装了官方源的旧版本,执行rpm -Uvh时可能会提示已安装,这时需要用rpm -qa | grep mysql查一下,手动清理后再装。

接着安装服务端:

yum install mysql-community-server -y

这个过程会自动把mysql-server、mysql-client、mysql-common等一堆组件一起装上。如果提示缺少依赖,比如libaio,直接用yum装一下:

yum install libaio -y

2.2 启动服务并找到初始密码

装完后第一步是初始化数据目录,然后启动服务:

systemctl start mysqld systemctl enable mysqld

MySQL 8.0在第一次启动时会自动初始化数据目录,并生成一个临时root密码,记录在错误日志里。查看方式:

grep 'temporary password' /var/log/mysqld.log

输出类似这样:

[Note] A temporary password is generated for root@localhost: xxxxxxxx

那个末尾的随机字符串就是临时密码。注意它可能包含特殊字符,复制的时候别漏掉。用这个密码登录:

mysql -uroot -p

登录成功后第一件事是改密码,因为在临时密码状态下什么操作都做不了:

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

新密码需要至少8位,并且包含大小写字母、数字和特殊字符,因为MySQL 8.0默认开启了密码校验插件,太简单的密码会被拒绝。如果确实想要宽松的密码策略,可以后面在配置里调整,但强调一下,生产环境别这么干。

2.3 Ubuntu/Debian系统的安装方式

Ubuntu这边稍微有一点不一样。最简单的方式是直接用系统自带的软件源:

apt update apt install mysql-server -y

但系统源里的版本往往不是最新的,可能落后好几个大版本。想要最新版,同样需要先配置官方Apt仓库。流程是去官方下载对应的.deb仓库包,然后:

dpkg -i mysql-apt-config_0.8.2x-1_all.deb apt update apt install mysql-server -y

安装过程中会弹出一个蓝屏界面让你选择要安装的MySQL版本,默认就是8.0,直接确认即可。Ubuntu默认安装的MySQL root账户使用的是auth_socket插件,特点是在本地可以用sudo mysql直接登录,不需要密码。如果你更习惯用密码登录,需要手动改一下认证方式:

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的新密码';

或者保持auth_socket也行,本地管理方便,但远程连接就要专门建一个账号,这个后面详细说。


3. 核心配置:my.cnf到底改什么

安装完成只是第一步,真正要让MySQL跑得稳,配置文件是关键。很多人装完就直接用了,结果跑不了多久就出现乱码、连接数爆掉、查询慢等问题,根子往往都在配置没调好。

3.1 配置文件优先级,别改错地方

MySQL读取配置文件的顺序是固定的,先读/etc/my.cnf,再读/etc/mysql/my.cnf,最后读~/.my.cnf,后面读到的配置会覆盖前面的同名项。CentOS上主配置文件一般是/etc/my.cnf,Ubuntu上可能在/etc/mysql/mysql.conf.d/mysqld.cnf。

我的建议是:把自定义配置统一写到一个显眼的位置,比如/etc/my.cnf,如果系统里本来就有多个配置文件,最好在[mysqld]段里用!includedir的方式统一引入一个目录,避免改了半天发现没生效。每次修改配置后都要重启服务:

systemctl restart mysqld

重启前建议先用mysqld --validate-config验证一下配置语法,别等起不来了再后悔。

3.2 必调的服务器参数

下面这份配置是我在项目里常用的基础模板,注释已经写在里面,可以直接抄:

[mysqld] # 端口和socket port = 3306 socket = /tmp/mysql.sock # 数据目录,不建议改,保持默认最省心 datadir = /var/lib/mysql # 字符集,8.0默认本来就是utf8mb4,这里再确认一遍 character-set-server = utf8mb4 collation-server = utf8mb4_0900_ai_ci # 连接数 max_connections = 500 max_connect_errors = 1000 # 缓存和事务日志 innodb_buffer_pool_size = 2G innodb_log_file_size = 256M innodb_flush_log_at_trx_commit = 2 # 慢查询日志 slow_query_log = 1 slow_query_log_file = /var/log/mysql-slow.log long_query_time = 2 # 其他 skip_name_resolve = 1 default-time-zone = '+08:00'

每个参数背后的逻辑,我展开说一下:

  • innodb_buffer_pool_size是InnoDB最重要的缓存,用来缓存数据页和索引页,官方建议设为物理内存的60%~70%。比如8G内存的机器,设5G左右比较合理。设得太大反而会因为内存不足导致系统使用swap,性能断崖式下跌。如果你是第一次调,先设到50%,观察几天内存使用率再逐渐往上加。
  • max_connections默认151对很多线上业务不够用,但也不要一味调大。每个连接都要占用内存,连接数翻倍意味着内存开销翻倍,我见过有人设置成2000,结果服务器直接OOM。一般来说200~500是一个比较合理的区间,配合下面要讲的连接池使用更好。
  • innodb_flush_log_at_trx_commit设置为2,可以在性能和数据安全之间取得一个比较好的平衡。它表示每次事务提交时把日志写入系统缓存但不强制刷盘,相当于最多丢失最近1秒的事务,在高并发场景下性能提升很明显。如果数据值钱到一秒都不能丢,那就得设1,但性能会有明显下降。
  • skip_name_resolve = 1表示关闭MySQL对客户端主机名的反向DNS解析。这个参数开了之后,远程连接会快很多,尤其是你用一个不存在的IP去连接时,默认解析超时可能让人以为机器卡住了。副作用是授权表里就不能用主机名,只能用IP。

3.3 慢查询日志与监控

前面模板里开了慢查询日志,long_query_time = 2表示超过2秒的SQL会被记录下来。这个日志是排查性能问题的第一手资料。我一般上线新项目时都会开着慢查询日志,哪怕一开始用不上,等哪天用户投诉系统卡了,翻日志就能找到罪魁祸首。

查看慢查询的方式也很简单:

tail -f /var/log/mysql-slow.log

如果日志内容太多,可以用mysqldumpslow命令汇总排序,看哪类SQL最频繁出现、平均耗时最长。

3.4 安全初始化:别跳过这一步

服务装好、配置改好之后,强烈建议执行安全初始化脚本:

mysql_secure_installation

这个脚本会一步一步问你:是否设置root密码、是否删除匿名用户、是否禁止root远程登录、是否删除test测试数据库、是否刷新权限表。全部选是即可。它做的事情虽然用SQL也能实现,但用脚本一次搞定,还能避免遗漏。

这个脚本执行完之后,MySQL的本地管理密码和权限就已经处于一个比较干净的状态了。注意这个脚本和初始化的临时密码是两个东西,很多人搞混,这个脚本是让你手动设置新密码并清理安全漏洞的交互工具,装完MySQL后多执行一次没坏处。


4. 高频问题与排查技巧

这一部分是我实测下来最容易踩的坑,每一个都有实际的排障经验,整理成表格方便对照。

4.1 服务启动失败

启动失败是最常见的,通常执行systemctl start mysqld后没有任何输出,但服务就是起不来。排查步骤:

systemctl status mysqld journalctl -u mysqld -n 50 tail -100 /var/log/mysqld.log

常见原因和解决办法:

现象原因处理方式
日志提示Permission denied数据目录属主不对chown -R mysql:mysql /var/lib/mysql
日志提示Can't create/write to file/var/run/mysqld目录不存在或权限不足mkdir -p /var/run/mysqld && chown mysql:mysql /var/run/mysqld
提示Port 3306 is already in use端口被其他进程占用`netstat -tlnp
提示配置参数错误my.cnf写错参数名或数值格式不对执行mysqld --validate-config检查

我碰到过一个比较隐蔽的情况:磁盘空间满了,导致MySQL初始化时写不进去binlog和redolog,启动日志里只显示一句很笼统的错。用df -h查一下根目录使用率,接近100%的话优先清磁盘。

4.2 忘记root密码

忘记root密码是另一个高频问题。解决方案是临时跳过权限验证,进入系统后手动修改密码。

具体步骤:

# 1. 停止服务 systemctl stop mysqld # 2. 编辑配置文件,在[mysqld]段末尾加一行 # skip-grant-tables # 3. 重启服务 systemctl start mysqld # 4. 这时可以免密登录 mysql -uroot # 5. 在MySQL里执行 FLUSH PRIVILEGES; ALTER USER 'root'@'localhost' IDENTIFIED BY '新的密码'; # 6. 退出后,把配置里的skip-grant-tables删掉,再重启

如果你在MySQL 8.0上执行ALTER USER报错,可以先FLUSH PRIVILEGES再执行一次。另外修改密码之后,记得刷新授权表让它生效。

这个操作有个风险点:在skip-grant-tables模式下,任何能登录到服务器的人都可以免密进入数据库,所以处理完一定要立刻删掉这个参数并重启,千万别留着过夜。

4.3 远程连接不上

本地登录没问题,但用Navicat、DBeaver之类的工具远程连接时,要么报2003 can't connect,要么报Access denied。分两种情况处理:

第一种是网络层面连不通,排查顺序是:

# 1. 确认MySQL监听地址,如果是127.0.0.1,改配置为0.0.0.0 netstat -tlnp | grep mysql # 2. 确认防火墙放行 firewall-cmd --permanent --add-port=3306/tcp && firewall-cmd --reload # 3. 确认云安全组是否放行,这个很多新手会忽略

配置里把bind-address设置为0.0.0.0后重启服务,MySQL才能接受外部连接。

第二种是认证和权限层面的问题。用root远程登录时,经常看到Access denied for user 'root'@'x.x.x.x'。这是因为root账号默认只允许localhost登录,安全起见也不建议放开root的远程权限。正确做法是创建一个专用账号:

CREATE USER 'app_user'@'%' IDENTIFIED BY '强密码'; GRANT SELECT, INSERT, UPDATE, DELETE ON mydb.* TO 'app_user'@'%'; FLUSH PRIVILEGES;

%表示允许任意主机登录,如果只想让某个IP段连,就写具体网段,比如'10.10.1.%'。我给项目中用的账号通常都限制IP范围,不给全网段权限。

还有一种是8.0的认证插件问题。如果客户端工具比较老,连的时候会报Authentication plugin 'caching_sha2_password' cannot be loaded,解决办法有两个:升级客户端工具,或者给账号指定老插件:

ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY '强密码';

不过从长远看,还是建议升级工具而不是兼容老插件。

4.4 Too many connections连接数爆了

业务跑着跑着突然报Too many connections,这个错误其实可以在监控里提前发现。查看当前连接情况:

SHOW STATUS LIKE 'Threads_connected'; SHOW STATUS LIKE 'Max_used_connections';

如果Max_used_connections已经接近max_connections,说明连接数配置已经到瓶颈了。优先检查有没有慢查询拖住了连接,可以用上面说的慢查询日志来分析。如果确认是正常业务量增长需要扩容,再修改max_connections。同时可以调大wait_timeout和interactive_timeout到600秒,让空闲连接更快释放,避免无效占用连接数。更推荐的方式是让应用侧使用连接池,比如Java的HikariCP、PHP的持久连接等,而不是每次请求都新建连接。


5. 结尾前的几点体会

写到这里,基本把MySQL从安装到配置再到常见排障的完整链路走了一遍。我个人在实际操作中有几个很深的体会:

第一,别一上来就追求“装最新版本”或者“参数调得飞快”。稳妥的路径是先装稳定版,跑通默认配置,观察几天再逐步调整。很多人一天之内把缓冲池、日志文件、并发数全改了一遍,结果连服务都起不来,排查半天才发现是参数写错。

第二,配置文件的备份很重要。每次修改my.cnf之前,先复制一份备份,比如my.cnf.bak。这样改出问题可以秒级回滚。这个习惯救过我很多次。

第三,如果条件允许,在正式环境搭建前先在一台测试机上完整走一遍安装和配置流程。数据库这种基础组件,多花一小时演练,就能避免上线时手忙脚乱。

第四,MySQL 8.0的初始化临时密码、安全初始化脚本、远程授权这三件事,是最容易出问题的三个环节,也是新用户最常卡住的地方。这篇里每一个我都给出了对应的操作和验证方法,只要按顺序执行,基本能够一次成功。

最后再分享一个小技巧:装完MySQL后,我会把这份配置和常用命令整理成一份简单的运维手册放在服务器上,团队其他人接手时不用重新踩一遍坑。你如果现在就是在帮别人装数据库,或者以后有这个打算,建议也顺手把过程记录一下,后续维护会轻松很多。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进