报错不一定表示目标索引表达到行数上限。排序和重建会创建磁盘临时表,磁盘、inode、tmpdir 或 InnoDB 临时表空间耗尽都可能返回相同信息。不要先 truncate 业务表。

先固定复现条件

保存完整异常堆栈和失败索引器,检查数据库主机而非仅 Web 节点的文件系统、inode、tmpdir 与 MySQL 错误日志。

df -h
df -i
mysql -e "SHOW VARIABLES LIKE 'tmpdir'; SHOW VARIABLES LIKE 'innodb_temp_data_file_path';"
mysql -e "SHOW GLOBAL STATUS LIKE 'Created_tmp%';"
php bin/magento indexer:reindex catalog_product_price -vvv

根据结果定位根因

磁盘利用率满、容器临时盘配额、过多临时文件或异常宽的自定义索引查询是常见根因。MEMORY 表还受 max_heap_table_size 限制,但不要不加区分地调大。

修复时保留回滚路径

先释放已确认可删除的日志/临时文件或扩容正确卷,再处理遗留临时表。优化自定义索引 SQL 与批次大小;变更 MySQL 临时表空间前做好备份和重启计划。

上线后的验收

单独重建失败索引器并确认 Ready,再运行完整索引。观察磁盘峰值、临时表数量与查询时间,下一轮定时增量不得再次耗尽空间。

生产环境操作前的检查

针对“Magento 2 重新索引报 The table is full”进行处理时,先记录 Magento 版本、部署模式、问题 Store View、复现时间和最近一次发布。所有 SQL 默认先执行 SELECT;需要 UPDATE、DELETE、补偿命令或目录删除时,必须先确认命中范围并保留可恢复备份。多 Web 节点环境还要比较代码版本、app/etc/env.php 摘要和当前流量节点,避免只修复其中一台。

php bin/magento --version
php bin/magento deploy:mode:show
php bin/magento maintenance:status
php bin/magento indexer:status
php bin/magento cache:status

命令应由 Magento 文件所有者在项目根目录执行。生产站不要同时运行多个全量索引或静态部署任务;若涉及数据库结构、库存、支付或订单,先在脱敏的生产数据副本验证,再安排维护窗口。

建立可比较的排查记录

每次实验只改变一个变量,并保存“操作前值、执行命令、开始时间、结束时间、结果、回滚方式”。至少准备一个正常对象和一个异常对象作对照,例如两个 SKU、两张订单或访客与登录客户。若修复后仅当前对象恢复,而新建对象仍会复现,说明根因尚未消除。

检查点需要记录通过标准
数据层 主键、Store/Website、更新时间、关联行数 关系完整且无孤儿记录
应用层 异常堆栈、模块、Cron/消费者状态 无新异常并可重复执行
缓存与索引 索引模式、版本、源站和公网响应 按预期周期自动更新
业务回归 正常路径、失败路径、重复请求 结果一致且没有重复副作用

修复后的观察窗口

上线后不要只刷新一次页面就结束。至少观察一轮 Cron、队列消费和索引周期,并在两台节点、无痕浏览器及目标 Store View 重复验证。对日志、数据库行数、错误率和响应时间设置临时观察项;确认它们稳定后再移除调试日志。调试日志可能包含客户、订单或令牌信息,采集时要脱敏,问题结束后及时关闭。