innodb_undo_log_truncate 是控制 Undo 表空间自动截断的动态变量，用于释放已过期 Undo 段占用的磁盘空间；需满足 innodb_undo_tablespaces≥2 等四个条件才生效，且仅对独立 Undo 表空间有效。
innodb_undo_log_truncate 是什么，为什么需要它
innodb_undo_log_truncate 是 InnoDB 的一个动态变量，控制是否启用 Undo 表空间的自动截断（truncate）机制。Undo 日志长期不清理会导致 ibdata1 或独立 Undo 表空间持续膨胀，尤其在高事务量、长事务或未及时 purge 的场景下。开启后，InnoDB 会在满足条件时把“已过期且不再被任何事务需要”的 Undo 段从 Undo 表空间中物理截断，释放磁盘空间。
但注意：它不等于实时清理，也不影响 Undo 日志的逻辑回收（那是 innodb_purge_threads 干的活），只是定期对空闲 Undo 表空间文件做收缩。
开启前必须满足的 4 个硬性条件
innodb_undo_log_truncate 不是设了就生效，MySQL 会检查全部前置条件，任一不满足都会静默忽略该开关：
-
innodb_undo_tablespaces必须 ≥ 2（即至少有 2 个独立 Undo 表空间，不能只有默认的ibdata1中的系统表空间） -
innodb_undo_directory必须指向可写的目录（推荐显式配置，避免默认落到 datadir 下造成权限/备份干扰） -
innodb_max_undo_log_size必须 > 0（单位 MB，默认 1024，表示单个 Undo 表空间达到该大小才考虑截断） - Undo 表空间必须是独立表空间模式（即
innodb_undo_logs已弃用，实际由innodb_undo_tablespaces管理）
检查方式：
SHOW VARIABLES LIKE 'innodb_undo%';若
innodb_undo_tablespaces 为 0 或 1，需先重建 Undo 表空间（需停机或使用 ALTER UNDO TABLESPACE ... SET INACTIVE 在线轮转）。
如何安全开启并验证是否真正生效
直接执行以下命令即可开启（5.7.21+ / 8.0+ 支持动态设置）：
SET GLOBAL innodb_undo_log_truncate = ON;
但光开开关不够，还需确认：
innodb_undo_truncate_frequency（默认 128）：表示每 purge 128 次后尝试一次截断判断。值越小越频繁，但太小会增加 I/O 开销-
截断动作实际发生时间不可控，取决于 purge 进度和 Undo 段空闲状态；可通过
INFORMATION_SCHEMA.INNODB_METRICS查看：SELECT * FROM INFORMATION_SCHEMA.INNODB_METRICS WHERE NAME LIKE 'undo%truncate%';
关注count字段是否随时间增长 最直接验证方式：观察 Undo 表空间文件大小变化（如
undo_001,undo_002），需等数小时到数天（取决于负载），不会立竿见影
常见误操作与后果
- 把
innodb_undo_log_truncate = ON 写进配置文件但没配 innodb_undo_tablespaces = 2 → 启动时 MySQL 不报错，但变量实际为 OFF，SHOW VARIABLES 显示 ON 是假象（因配置加载顺序问题导致依赖项未就绪）
- 在只有一个 Undo 表空间（
innodb_undo_tablespaces = 1）时强行开启 → 截断逻辑跳过，磁盘占用照涨不误
- 误以为开启后能清理历史长事务残留的 Undo → 实际上只要还有活跃事务或 purge lag，对应 Undo 段就不能被截断，哪怕空间已满
- 使用
TRUNCATE TABLE 或 DROP TABLE 清理 Undo 表空间 → 完全错误，Undo 表空间不是普通表，只能通过 InnoDB 自身机制管理
innodb_undo_log_truncate = ON 写进配置文件但没配 innodb_undo_tablespaces = 2 → 启动时 MySQL 不报错，但变量实际为 OFF，SHOW VARIABLES 显示 ON 是假象（因配置加载顺序问题导致依赖项未就绪）innodb_undo_tablespaces = 1）时强行开启 → 截断逻辑跳过，磁盘占用照涨不误TRUNCATE TABLE 或 DROP TABLE 清理 Undo 表空间 → 完全错误，Undo 表空间不是普通表，只能通过 InnoDB 自身机制管理Undo 表空间截断是个“后台慢动作”，依赖 purge 进度、事务生命周期和配置协同。最容易被忽略的是：它只对独立 Undo 表空间文件起作用，而很多人还在用默认的共享表空间（ibdata1），这种情况下无论怎么开 innodb_undo_log_truncate 都无效。
