最稳妥写法是alter table table_name add index index_name(column_name);需注意索引名唯一、text/blob字段须指定前缀长度、联合索引字段顺序影响性能,且大表应优先用algorithm=inplace, lock=none。

ALTER TABLE ADD INDEX 语法怎么写才不报错
直接用 ALTER TABLE table_name ADD INDEX index_name (column_name) 是最稳妥的写法。MySQL 5.7+ 支持在线 DDL(ALGORITHM=INPLACE),但默认行为仍可能锁表,尤其在大表上——别等执行完才发现服务卡住。
常见错误包括:ERROR 1061 (42000): Duplicate key name 'idx_user_id'(索引名重复)、ERROR 1170 (42000): BLOB/TEXT column 'content' used in key specification without a key length(对 TEXT 字段建索引没指定前缀长度)。
- 索引名必须唯一,建议统一加前缀如
idx_或uk_(唯一索引) - 对
VARCHAR(500)或TEXT字段建索引,必须显式指定长度:ADD INDEX idx_title (title(191)) - 联合索引字段顺序影响查询效率,把区分度高、常用于
WHERE条件的字段放前面
什么时候该用 UNIQUE 而不是普通 INDEX
当字段组合天然具备唯一性(如用户邮箱、订单号、API 请求 ID),且业务层无法 100% 保证不重复时,UNIQUE 不只是优化手段,更是数据完整性兜底。MySQL 在插入/更新时会自动校验,比应用层判断更可靠。
注意:UNIQUE 允许 NULL 值多次出现(标准 SQL 行为),如果字段本身允许为空又需要强制唯一,得配合 NOT NULL 使用。
- 建唯一索引:
ALTER TABLE users ADD UNIQUE uk_email (email) - 若已有重复数据,命令会直接失败,需先清理:
SELECT email, COUNT(*) FROM users GROUP BY email HAVING COUNT(*) > 1 - 唯一索引被违反时抛出错误:
ERROR 1062 (23000): Duplicate entry 'test@example.com' for key 'uk_email'
大表加索引卡住或超时怎么办
500 万行以上的表,直接 ALTER TABLE 很可能触发全表拷贝(COPY 算法),耗时长、磁盘暴涨、主从延迟飙升。不要在业务高峰期操作。
优先考虑 ALGORITHM=INPLACE, LOCK=NONE(MySQL 5.6+),但前提是满足条件:不能是全文索引、空间索引;目标列不能有默认值或生成列依赖;引擎必须是 InnoDB。
- 安全起见,先检查是否支持:
SELECT @@version, @@innodb_file_per_table;,确保是 InnoDB 且独立表空间开启 - 显式指定轻量级方式:
ALTER TABLE orders ADD INDEX idx_status_created (status, created_at) ALGORITHM=INPLACE, LOCK=NONE; - 仍失败?用
pt-online-schema-change工具,它通过影子表+触发器实现无锁变更,但要求主键存在、无外键
加完索引为什么查询没变快
索引建了≠生效。常见原因是查询条件没命中索引最左前缀,或者优化器认为全表扫描更快(比如 WHERE status IN ('pending','done') 返回 80% 数据,MySQL 就会跳过索引)。
用 EXPLAIN 看执行计划,重点关注 type(应为 ref/range,不是 ALL)、key(是否用了你建的索引)、rows(预估扫描行数)。
- 避免在索引列上做函数操作:
WHERE YEAR(created_at) = 2024无法走索引,改用created_at >= '2024-01-01' AND created_at - 隐式类型转换也会失效:
WHERE user_id = '123'(user_id是INT)会导致索引失效 - 联合索引中,跳过中间字段会导致后续字段失效:
INDEX (a,b,c),WHERE a=1 AND c=3只能用到a,c不走索引











