MySQL 8.0 的 undo 表空间必须初始化前仅设 innodb_undo_directory,运行时用 CREATE/ALTER/DROP UNDO TABLESPACE 管理;innodb_undo_tablespaces 已废弃,设了会警告且无效。

MySQL 8.0 的 undo 表空间不能靠配置文件“配出来”,必须初始化前设 innodb_undo_directory,运行时用 SQL 管理;硬塞 innodb_undo_tablespaces 不但无效,还会在错误日志里打警告。
初始化前只该配 innodb_undo_directory
这个参数是 MySQL 8.0 初始化(mysqld --initialize)前唯一值得设置的 undo 相关项。它只影响默认生成的两个隐式 undo 表空间文件 undo_001.ibu 和 undo_002.ibu 的初始存放路径,且仅首次初始化生效。
- 目标目录必须提前创建,且属主为
mysql用户:mkdir -p /ssd/mysql/undo && chown mysql:mysql /ssd/mysql/undo - 配置写在
my.cnf的[mysqld]段下:innodb_undo_directory = /ssd/mysql/undo - 初始化完成后改这个参数并重启,不会移动已有
undo_*.ibu文件——它们已固化在数据字典里 - 别碰
innodb_undo_tablespaces:8.0.14 起废弃,8.0.21 后彻底移除;设了会触发警告[Warning] InnoDB: Ignoring innodb_undo_tablespaces because it is deprecated.
运行中新增表空间必须用 CREATE UNDO TABLESPACE
MySQL 8.0 的 undo 表空间是对象化的,数量、路径、状态全由 SQL 控制,无法通过配置热加载。
- 加第三个表空间:
CREATE UNDO TABLESPACE undo_003 ADD DATAFILE '/ssd/mysql/undo/undo_003.ibu'; -
ADD DATAFILE后必须是绝对路径,且该路径需在innodb_directories列表中,或直接落在datadir下;文件名必须以.ibu结尾 - 新建表空间默认为
INACTIVE状态,需手动激活:ALTER UNDO TABLESPACE undo_003 SET ACTIVE; - 停用旧表空间前,必须确认无活跃事务依赖它:
ALTER UNDO TABLESPACE undo_001 SET INACTIVE; - 删除前必须先停用,再
DROP UNDO TABLESPACE undo_001;,否则报错
innodb_undo_log_truncate 开了也不等于自动收缩文件
开启 innodb_undo_log_truncate = ON 只是允许截断的许可开关,实际触发需同时满足四个硬性前提,缺一不可:
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。
-
innodb_undo_tablespaces ≥ 2:至少两个独立 undo 表空间(undo_001、undo_002是默认的,满足) -
innodb_max_undo_log_size > 0:默认 1G,单位字节;建议设为2147483648(2G) - 至少一个 undo 表空间的
TRUNCATE_STATUS为truncate_ready,查法:SELECT NAME, TRUNCATE_STATUS FROM INFORMATION_SCHEMA.INNODB_TABLESPACES WHERE NAME LIKE 'undo%'; - 无长事务、未提交事务或残留的
XA PREPARED事务——它们会锁住 rollback segment,阻止状态切换
即使全部满足,InnoDB 的 truncate 是逻辑操作:重置 LSN、清空页内数据、标记空间可复用,但不会调用 ftruncate() 缩小文件尺寸。所以 ls -lh undo_001.ibu 看到的大小纹丝不动,不是配置失败,是设计如此。
想真正释放磁盘空间?得停用 + 删除 + 重建
如果 undo 文件已膨胀到占满磁盘,光靠 truncate 不够:
- MySQL 8.0.30+ 可执行
OPTIMIZE TABLESPACE undo_001;,但要求表空间处于INACTIVE状态 - 更稳妥的做法是停库后轮转:先
ALTER UNDO TABLESPACE undo_001 SET INACTIVE;,等 purge 完成(查INFORMATION_SCHEMA.INNODB_TRX确认无长事务),再DROP UNDO TABLESPACE undo_001;,最后新建 - 注意:默认的
undo_001和undo_002不能直接 DROP,必须先添加第三个(如undo_003)并完成轮转 - 日常监控关键命令:
SHOW VARIABLES LIKE 'innodb_undo%';、SELECT * FROM INFORMATION_SCHEMA.INNODB_METRICS WHERE NAME LIKE 'undo%truncate%';、SELECT * FROM INFORMATION_SCHEMA.INNODB_TRX ORDER BY TRX_STARTED LIMIT 5;
最易被忽略的点:配置项只是起点,真实状态要看数据字典和运行时指标;而长事务才是 undo 空间失控的真正开关,不是参数没设对,是业务没管住。










