MySQL 不可见索引被 USE INDEX 指定时为什么报错

MySQL 把索引改成 INVISIBLE 后，优化器默认不会把它放进执行计划候选集合；如果旧 SQL 还用 USE INDEX 或 FORCE INDEX 点名这个索引，提示与索引状态就发生了冲突，因此查询会报错。这个错误不是索引文件被删除，而是查询仍在引用一个对优化器不可见的对象。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/invisible-indexes.html

处理顺序很简单：先确认索引确实是不可见，再决定是恢复为 VISIBLE 以兼容现有提示，还是移除提示并只在验证执行计划时临时打开 use_invisible_indexes。不要把单次验证开关当成长期修复。

为什么 USE INDEX 指定不可见索引会报错

不可见索引的用途，是在不删除索引的情况下观察“少了它”会怎样。它仍会随数据变化维护，唯一索引仍然承担唯一性约束，但默认不参与优化器的计划构建。于是下面这类 SQL 的意图很明确：要求 MySQL 使用 idx_customer；而表定义又明确告诉优化器暂时忽略它。

-- 这个查询显式点名一个已经设为 INVISIBLE 的索引
SELECT order_id, created_at
FROM orders USE INDEX (idx_customer)
WHERE customer_id = 1001;

官方文档把“索引提示引用不可见索引产生错误”列为不可见索引影响查询的信号之一。FORCE INDEX 也不能绕过这个状态；它只是比 USE INDEX 更强地要求在指定索引中寻找可用路径，并不会把不可见索引重新变成可见。

先确认索引可见性和提示作用域

先查状态，不要看到报错就直接重建索引。SHOW INDEX 适合快速查看；需要把结果纳入排查脚本时，可以查询 Information Schema。

-- 先确认索引名和可见性，避免把同名或拼写错误当成状态问题
SHOW INDEX FROM orders;

-- 用结果集明确记录目标索引当前是否可见
SELECT INDEX_NAME, IS_VISIBLE
FROM INFORMATION_SCHEMA.STATISTICS
WHERE TABLE_SCHEMA = DATABASE()
  AND TABLE_NAME = 'orders'
  AND INDEX_NAME = 'idx_customer';

如果 IS_VISIBLE 为 NO，再检查 SQL 是否在查询块、FOR JOIN、FOR ORDER BY 或 FOR GROUP BY 作用域里引用了它。没有 FOR 子句的提示，作用范围更宽；排查时要把视图、ORM 生成 SQL 和存储过程一起考虑。

按使用场景选择可见性修复方案

如果线上 SQL 必须保留这个索引提示，最直接的兼容修复是恢复索引可见性：

-- 恢复现有提示可以使用的索引状态
ALTER TABLE orders ALTER INDEX idx_customer VISIBLE;

-- 重新检查状态，再观察原查询的执行计划
SHOW INDEX FROM orders;

如果这个提示只是历史遗留，且你希望让优化器重新选择，可以改写 SQL，删除 USE INDEX，再用 EXPLAIN 比较计划。另一条路径只适合验证：对单条语句临时打开不可见索引参与计划构建。

-- 只为本次 EXPLAIN 打开不可见索引，验证它是否仍有计划价值
EXPLAIN SELECT /*+ SET_VAR(optimizer_switch = 'use_invisible_indexes=on') */
  order_id, created_at
FROM orders
WHERE customer_id = 1001;

这里故意没有继续写 USE INDEX (idx_customer)：SET_VAR 的意义是让优化器在这一次构建计划时考虑不可见索引，不是把显式提示的冲突永久消除。验证完成后，生产修复仍应回到索引可见性或 SQL 提示本身。

上线前怎样收敛排查边界

恢复可见或删除提示之后，至少保留三项记录：原 SQL 的错误时间和调用入口、修改前后的 EXPLAIN 结果、以及慢查询或 Performance Schema 中受影响语句的变化。不可见索引本来就是为了低风险观察退役影响，不能只看某一次查询成功就宣布可以删除。

• 要兼容明确写死的 USE INDEX：优先恢复 VISIBLE，再安排提示治理。
• 要评估索引是否还能退役：移除提示，用 EXPLAIN 和真实负载观察，而不是只改错误文本。
• 要做一次性实验：使用带 SET_VAR 的单条语句，避免改变全局优化器开关。

常见问题

不可见索引是不是已经删除了？

不是。它仍然存在并维护数据，唯一索引的约束也仍然有效；变化主要在优化器是否把它当作候选。

把 USE INDEX 换成 FORCE INDEX 能解决吗？

不能。两者都是索引提示，FORCE INDEX 不会改变索引的可见性；应恢复可见、移除提示，或仅做单次计划验证。