这篇解决什么问题
从这一篇开始进入 MySQL 部分。目标很具体:把 MySQL 8.4 LTS 以正确的姿势跑起来——字符集不错、时区不错、关键参数不踩默认值坑,后面讲用户权限和命令实战时就不用再回头补课。
安装路线有两条:Docker Compose 和系统包安装。本系列整体推荐 Docker 路线(用 Docker 快速搭建三大数据库 里已经给过三合一的 Compose),这一篇会把 MySQL 单独拆开讲透,并补上系统包安装方式方便对照。选型还没想清楚的,先看 数据库怎么选。
路线一:Docker Compose 部署(推荐)
目录结构与 Compose 文件:
mkdir -p ~/mysql8/{data,conf,logs} && cd ~/mysql8services: mysql: image: mysql:8.4 container_name: mysql8 restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: "ChangeMe_2026!" TZ: Asia/Shanghai ports: - "127.0.0.1:3306:3306" volumes: - ./data:/var/lib/mysql - ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro - ./logs:/var/log/mysql command: --character-set-server=utf8mb4 --collation-server=utf8mb4_0900_ai_ci自定义配置文件 conf/my.cnf:
[mysqld]# 基础character-set-server = utf8mb4collation-server = utf8mb4_0900_ai_cidefault-time-zone = '+08:00'max_connections = 300wait_timeout = 28800
# InnoDB(内存按机器规格调整,下面按 4 GB 内存机器示例)innodb_buffer_pool_size = 2Ginnodb_log_file_size = 512Minnodb_flush_log_at_trx_commit = 1sync_binlog = 1
# 日志:慢查询先开起来,下一篇优化全靠它slow_query_log = 1slow_query_log_file = /var/log/mysql/slow.loglong_query_time = 1log_error = /var/log/mysql/error.log启动并验证:
docker compose up -ddocker compose logs -f mysql # 看到 ready for connections 再继续docker exec -it mysql8 mysql -uroot -p -e "SELECT VERSION(); SHOW VARIABLES LIKE 'character_set_server';"路线二:系统包安装(Debian / Ubuntu)
MySQL 官方 APT 仓库提供 8.4 LTS。简化流程如下:
# 安装官方仓库配置包后sudo apt updatesudo apt install -y mysql-server
sudo systemctl enable --now mysqlsudo mysql_secure_installationmysql_secure_installation 会引导设置 root 密码强度策略、删除匿名用户、禁止 root 远程登录、删除 test 库,这一步不要跳过,它是裸装 MySQL 最重要的安全动作。系统包方式的配置文件在 /etc/mysql/mysql.conf.d/mysqld.cnf,参数名与上面 my.cnf 完全通用。
两条路线对比:
| 维度 | Docker Compose | 系统包安装 |
|---|---|---|
| 环境隔离 | 好,版本切换靠换镜像 tag | 与系统耦合,升级走 APT |
| 数据目录 | 宿主机挂载目录,直观可控 | /var/lib/mysql |
| 配置位置 | 项目内 conf/my.cnf | /etc/mysql/ |
| 适合场景 | 个人服务器、多实例、快速试错 | 长期单实例、习惯 systemd 管理 |
| 备份迁移 | 打包目录即可搬走 | 需配合 mysqldump 或停机拷数据 |
初始配置的四个必查项
1. 字符集必须是 utf8mb4
MySQL 历史上的 utf8 是残缺版(每字符最多 3 字节),存不下 emoji 和部分生僻字。新装实例一律 utf8mb4,排序规则用 utf8mb4_0900_ai_ci(8.x 默认)或需要区分大小写时用 utf8mb4_bin。验证:
SHOW VARIABLES LIKE 'character_set%';SHOW VARIABLES LIKE 'collation%';建库时也显式写明,别依赖默认值漂移:
CREATE DATABASE appdb CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;2. 时区显式设为 +08:00
TIMESTAMP 类型会按时区转换存储与显示,时区不一致是「时间差了 8 小时」类 Bug 的头号来源。Docker 方式已通过环境变量和 my.cnf 双保险;系统包安装记得在 my.cnf 写 default-time-zone = '+08:00',并确认系统时区正确:
SELECT @@global.time_zone, @@session.time_zone, NOW();3. InnoDB 缓冲池按内存给
innodb_buffer_pool_size 是 MySQL 最重要的性能参数,决定多少热数据能留在内存里。经验值:专职数据库机器给物理内存的 50%–70%,与其它服务混跑时保守些。给太小查询全走磁盘,给太大则可能触发 OOM。修改后需重启生效(8.0 起部分场景支持在线调整,但重启最稳妥)。
4. root 账号只用于初始化
官方镜像首次启动时用环境变量里的密码初始化 root。初始化完成后,第一件事应该是创建业务账号和管理员账号,root 只留作应急。账号体系与授权方法在下一篇 MySQL 用户权限与安全管理 专门讲,这里先记住原则:不要用 root 账号跑业务程序,更不要把 root 开放到公网远程登录。
WARNINGDocker 部署时端口绑定务必注意:
ports写成"3306:3306"等于对所有网卡开放,配合弱密码很容易被扫描爆破。本文示例绑定127.0.0.1:3306只允许本机访问,需要远程连接时优先走 SSH 隧道或内网,不要图省事直接把 3306 暴露到公网。
常用参数速览:知道每个参数在管什么
上面 my.cnf 里出现的参数只是起步集,这里把日常最常打交道的参数汇成一张表,调优时对照着看:
| 参数 | 默认值(8.4) | 作用 | 调整建议 |
|---|---|---|---|
max_connections | 151 | 允许的最大并发连接数 | 按应用连接池总量留 20% 余量,不是越大越好,每个连接都占内存 |
innodb_buffer_pool_size | 128M | InnoDB 数据与索引的缓存区 | 默认值小得离谱,装完第一件事就是按内存改大 |
innodb_log_file_size | 48M | Redo 日志单个文件大小 | 写密集型可调到 512M–1G,减少刷盘频率 |
max_allowed_packet | 64M | 单个数据包最大大小 | 导入大 SQL 文件或存大字段时报包过大,就是调它 |
wait_timeout | 28800 秒 | 非交互连接的空闲断开时间 | 连接池场景可适当调小,避免僵尸连接占坑 |
slow_query_log | OFF | 慢查询日志开关 | 生产必须开,阈值起步设 1 秒 |
binlog_expire_logs_seconds | 2592000(30 天) | binlog 自动过期时间 | 磁盘紧张时调小,但要先确认备份与主从不再需要老日志 |
character_set_server | utf8mb4 | 服务端默认字符集 | 8.x 默认已是 utf8mb4,老实例升级来的要专门确认 |
查参数当前值与来源的命令:
-- 看某个参数现在是多少SHOW GLOBAL VARIABLES LIKE 'innodb_buffer_pool_size';
-- 看某个参数是在哪个配置文件里定义的(Performance Schema,8.0+)SELECT VARIABLE_NAME, VARIABLE_SOURCE, SET_TIMEFROM performance_schema.variables_infoWHERE VARIABLE_NAME IN ('max_connections', 'innodb_buffer_pool_size');VARIABLE_SOURCE 会告诉你值来自编译默认(COMPILED)、配置文件(FILE)还是运行时动态修改(DYNAMIC),排「改了配置没生效」类问题时特别好用。
连接与健康检查
# 宿主机装了客户端时mysql -h 127.0.0.1 -P 3306 -uroot -p
# 没装客户端就借容器内的docker exec -it mysql8 mysql -uroot -p连上后跑一轮体检 SQL:
SHOW VARIABLES LIKE 'max_connections';SHOW VARIABLES LIKE 'innodb_buffer_pool_size';SHOW STATUS LIKE 'Threads_connected';SHOW ENGINE INNODB STATUS\G最后一段 SHOW ENGINE INNODB STATUS 输出很长,重点看有没有死锁记录和异常等待,日常排障时是重要线索。
常见问题
Q:容器反复重启,日志报 Table 'mysql.plugin' doesn't exist 或数据目录权限错误?
多半是 data 目录曾经被其它版本或空目录污染。确认目录里没有要保留的数据后清空重新初始化;另外宿主机目录属主问题在官方镜像里一般会自动处理(容器内以 mysql 用户运行),不要手动乱改属主。
Q:改了 my.cnf 没生效?
先确认挂载路径对不对:官方镜像读取 /etc/mysql/conf.d/ 和 /etc/mysql/mysql.conf.d/ 下的配置。用 docker exec mysql8 mysqld --verbose --help | grep -A1 'Default options' 查看它实际读取的配置文件列表。
Q:Access denied for user 'root' 本地都登不上?
Docker 方式先确认连的是不是刚初始化的那个实例、密码是否与环境变量一致。注意:MYSQL_ROOT_PASSWORD 只在数据目录为空、首次初始化时生效,事后改环境变量不会修改已有密码,改密码要用 SQL:
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewStrongPass_2026!';Q:内存只有 1–2 GB 的小机器参数怎么调?
innodb_buffer_pool_size 给 256M–512M,max_connections 降到 100 以内,并关掉不用的功能如 Performance Schema 的部分消费者。小机器能跑稳比参数好看重要。
小结
- 推荐 Docker Compose 部署 MySQL 8.4,配置、数据、日志都落在项目目录里,可控可迁移。
- 初始配置四件套:utf8mb4 字符集、
+08:00时区、合理大小的 InnoDB 缓冲池、root 只作初始化。 - 安全底线:跑
mysql_secure_installation(系统包)或等效处理,3306 不裸奔公网。
环境就绪,下一篇给它上锁:MySQL 用户权限与安全管理;日常操作命令则在 MySQL 常用命令与操作实战 里系统梳理。