千万级表加索引应使用pt-online-schema-change（pt-osc），它通过影子表+触发器实现无锁变更，前提是有主键或唯一非空索引、无外键、text/blob索引需前缀、binlog_format=row。
直接用 ALTER TABLE 加索引在千万级表上极大概率卡住业务，真正能落地的无锁方案只有 pt-online-schema-change（pt-osc）——它不依赖 MySQL 原生 DDL 能力，而是靠影子表 + 触发器兜底，只要主键存在、无全表扫描式查询干扰，就能稳住读写。
确认表结构是否满足 pt-osc 基本前提
不是所有表都能直接跑 pt-osc，先快速排除硬性障碍：
-
SHOW CREATE TABLE your_table\G中必须有明确的主键或唯一非空索引（否则无法分块拷贝） - 不能有外键约束：
SELECT CONSTRAINT_NAME FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA = 'db' AND TABLE_NAME = 'your_table' AND REFERENCED_TABLE_NAME IS NOT NULL;返回空才安全 - 避免
TEXT/BLOB列参与索引定义（如要建索引，必须带前缀：ADD INDEX idx_content (content(255))） - 确保
binlog_format = ROW（SELECT @@binlog_format;），否则触发器同步增量会失效
执行 pt-osc 添加索引的关键命令与参数
不要只写 --alter，必须显式控制行为边界，否则默认策略可能在高峰期拖垮复制延迟：
- 核心命令示例：
pt-online-schema-change --host=localhost --user=root --password=xxx --database=your_db --table=your_table --alter="ADD INDEX idx_create_time (create_time)" --execute --no-check-alter --chunk-size=1000 --max-load="Threads_running=25" --critical-load="Threads_running=50" -
--chunk-size=1000：每批拷贝 1000 行，太大会压爆 I/O，太小则触发器开销占比过高 -
--max-load和--critical-load：实时监控Threads_running，超阈值自动暂停，防止拖慢线上查询 -
--no-check-alter：跳过对--alter语句的语法校验（MySQL 5.7 对某些索引定义报错但实际可执行，此参数防误判中断） - 务必加
--execute，不加只会预演，不真干
为什么加索引时还要关注主从延迟和 tmpdir？
pt-osc 不是完全“零成本”，它会在拷贝阶段持续写 binlog，并在从库回放时放大延迟。同时，临时文件生成位置不当会导致失败：
- 主从延迟突增常见于大事务堆积，
pt-osc默认按主键范围分块，但如果主键不连续或存在大量删除空洞，--chunk-index可指定更稳定的索引列（如时间字段） -
tmpdir必须指向 SSD 且剩余空间 > 表大小 × 1.5，否则中间生成的_your_table_new文件写满磁盘直接中止 - 检查当前
tmpdir：SELECT @@tmpdir;，必要时启动时加--tmpdir=/ssd/tmp - 若从库已延迟 > 60 秒，建议先暂停
pt-osc，等追平再继续（用--pause-file控制）
加唯一索引前必须手动查重，pt-osc 不报具体冲突行
pt-osc 在影子表上执行 ALTER，一旦遇到重复值，整个流程会失败并留下 _your_table_new 表，但错误信息只显示 Duplicate entry 'xxx' for key 'uk_xxx'，不会告诉你哪几行冲突：
- 执行前必做：
SELECT create_by, COUNT(*) FROM your_table GROUP BY create_by HAVING COUNT(*) > 1;（替换成你要建唯一索引的字段） - 如果发现重复，要么清理数据，要么改用普通索引（
INDEX而非UNIQUE INDEX） - 注意：即使原表没重复，触发器同步期间若并发写入相同值，也可能导致影子表冲突，所以加唯一索引应尽量选低频更新字段
真正麻烦的不是命令怎么写，而是你没法靠日志判断 pt-osc 是在正常拷贝、还是卡在某一批 chunk、或是被触发器同步拖住——得盯着 processlist 里有没有长时间运行的 INSERT ... SELECT 或 TRIGGER 相关线程，以及 SHOW SLAVE STATUS\G 的 Seconds_Behind_Master 是否持续上涨。
