老唐笔记
Yoast SEO 后台 Tools 页面里的 SEO 数据优化（SEO data optimization）卡在某个进度不动，或者跑完提示无法完成，常见原因是 indexables 索引表出了错。Yoast 官方给的修法是装 Yoast Test Helper 插件，把 indexables 数据表和迁移记录重置，再重新跑一次数据优化。这篇老唐按官方帮助页的七个步骤配图讲一遍，再补上重置前的备份、重置后的验证、两条官方注意事项，以及在 VPS 上跑 WordPress 时可以多做的几件事。截至 2026-10-30，Yoast SEO 最新版本是 28.8，Yoast Test Helper 是 1.19。
1. 什么是 Yoast indexables
Yoast 在 14.0 版本引入了 indexables。按官方的说法，这是一种更快、更高效的方式，用来收集站点各个页面的数据，做优化，再把这些信息呈现给搜索引擎。
可以把它理解成 Yoast 给全站内容建的一份 SEO 数据汇总：文章、页面、分类、作者页等各对应一条记录，前台输出 SEO 标签时从这里取。这些数据存在几张以 wp_yoast_ 开头的表里，主表是 wp_yoast_indexable。建站时改过表前缀的，表名就是”你的前缀 + yoast_indexable”。
关键在于，indexables 是从文章、分类这些原始数据生成出来的，原始数据还在，汇总表坏了可以重建。重置能解决问题，靠的就是这一点。
官方也说了，受站点配置影响，生成 indexables 的过程可能会出错。出错之后，数据优化跑不完，前台输出的 SEO 信息也可能和实际内容对不上。
2. 什么时候需要重置
遇到下面几种情况，老唐建议考虑重置：
- Yoast SEO → Tools 里的 SEO 数据优化进度条卡住，等很久不动，重新点一次还是卡在差不多的位置。
- 数据优化跑完弹出报错，提示无法完成 SEO 数据的优化。
- 网站搬家、换域名或改过固定链接后，页面源代码里的 canonical、og:url、面包屑还是旧地址。
- 后台反复提示需要做 SEO 数据优化，跑完也消不掉。
如果只是某一篇文章的 SEO 标题不对，先去编辑那篇文章，看 Yoast 面板里填的内容。重置针对的是全站数据，不用当成日常维护来做。
3. 重置前的准备
3.1 备份数据库
重置会清空 indexables 相关的数据表。这些表能重新生成，但动数据库之前先备份，是老规矩。宝塔面板、主机商控制面板一般都有一键备份；有 SSH 的话可以用 mysqldump：
# 导出整个数据库，用户名和库名换成 wp-config.php 里 DB_USER、DB_NAME 的值
# 回车后输入数据库密码
mysqldump -u 数据库用户名 -p 数据库名 > wp-backup-20261019.sql备份文件下载到本地或另存一份，别只放在同一台服务器上。
3.2 核对版本
以下是 2026-10-30 在 wordpress.org 上查到的信息：
| 插件 | 当前版本 | 更新日期 | 兼容信息 |
|---|---|---|---|
| Yoast SEO | 28.8 | 2026-10-27 | 建议先升到最新版再操作 |
| Yoast Test Helper | 1.19 | 2026-10-06 | 要求 WordPress 7.0 及以上，已测试到 7.1.4 |
WordPress 还停在 7.0 以下的站，先升级 WordPress，再装 Yoast Test Helper。
3.3 选低峰期
重新生成 indexables 要把全站内容逐条处理一遍，会占用数据库和 PHP 资源。内容少的站影响小，上万篇的站最好放在访问最少的时段做。
3.4 确认是正式站
官方特别说明：indexables 在非生产环境和 staging（预发布、测试）站点上不工作。在测试站上演练，结果代表不了正式站。这一条在第 6 节还会展开。
4. 七步重置 indexables
下面七步和 Yoast 官方帮助页 How to reset the Yoast indexables 一致。截图是英文后台，中文后台菜单名会被翻译，位置不变。
第 1 步：打开 Plugins
登录 WordPress 后台，点左侧菜单的 Plugins（中文后台叫”插件”）。
WordPress 后台左侧菜单的 Plugins 入口
在 WordPress 仪表盘左侧菜单找到 Plugins（截图来自 Yoast 官方帮助页）
第 2 步：点 Add New Plugin
在 Plugins 菜单里点 Add New Plugin（中文后台是”安装插件”）。
Plugins 菜单里的 Add New Plugin
Plugins 菜单下的 Add New Plugin，进入插件安装页（截图来自 Yoast 官方帮助页）
第 3 步：安装并启用 Yoast Test Helper
在搜索框输入 Yoast Test Helper，认准作者 Team Yoast，点安装，装好后点启用。
后台没法直接安装的，可以去 wordpress.org 的 Yoast Test Helper 插件页下载 zip，再回到 Add New Plugin 页面点 Upload Plugin 上传。
安装并启用 Yoast Test Helper 插件
搜索 Yoast Test Helper，安装后启用（截图来自 Yoast 官方帮助页）
第 4 步：打开 Tools → Yoast Test
插件启用后，左侧 Tools（工具）菜单下会多出一项 Yoast Test，点进去。
Tools 菜单下的 Yoast Test
Yoast Test Helper 的入口在 Tools 菜单下（截图来自 Yoast 官方帮助页）
第 5 步：点 Reset indexables tables & migrations
在 Yoast Test 页面找到 Yoast SEO 这一栏，点 Reset indexables tables & migrations。
按钮名字已经说明了它做的事：清掉 indexables 数据表和对应的迁移记录，让 Yoast 重新建表。点之前再确认一次备份已经做好。
Yoast Test Helper 里的 Reset indexables tables & migrations 按钮
Yoast SEO 栏目下的 Reset indexables tables & migrations 按钮（截图来自 Yoast 官方帮助页）
第 6 步：打开 Yoast SEO → Tools
回到左侧菜单的 Yoast SEO，打开 Tools。
Yoast SEO 菜单下的 Tools
Yoast SEO 菜单下的 Tools，SEO 数据优化在这个页面（截图来自 Yoast 官方帮助页）
第 7 步：点 Start data optimization
在 Tools 页面点 Start data optimization，重新跑 SEO 数据优化。截图里这个按钮写的是 Start SEO data optimization，不同版本措辞略有差别，是同一个按钮。表已经清空，这一步就是把全站内容重新收录进 indexables。
进度条走完之前别关页面，也别刷新。文章多的站要等一阵，中途断了就回到这个页面再点一次。
点击 Start data optimization 重新生成索引
点 Start data optimization，等进度条走完（截图来自 Yoast 官方帮助页）
5. 重置后怎么验证
进度条走完不等于万事大吉，老唐一般再看四处：
- Tools 页面：数据优化显示完成，没有报错提示。
- 页面源代码：打开几篇不同类型的文章和页面，按 Ctrl+U（Mac 是 Cmd+Option+U）看源代码，搜
canonical和og:url，确认地址是当前域名和当前固定链接。搬家、换域名之后重置的，这一项最要紧。 - 数据表：用 phpMyAdmin 或命令行看主表有没有重新写入数据。
-- 表前缀不是 wp_ 的，改成自己的前缀
SELECT COUNT(*) FROM wp_yoast_indexable;这个数随全站内容多少而变，重点是不能是 0，也不应该明显少于已发布的文章数。是 0 或很少，说明数据优化没跑完。
- 站点地图：打开
你的域名/sitemap_index.xml，点进文章的子地图，看新旧文章是不是都在。
确认没问题后，回到 Plugins 页面把 Yoast Test Helper 停用并删除。它是 Yoast 出的测试辅助插件，用完不必留在正式站上。
6. 常见报错和处理
6.1 数据优化报错
数据优化过程中出现报错，看 Yoast 官方的这篇指南：We couldn’t complete the optimization of your SEO data。报错的具体原因和对应处理，以官方指南为准，老唐这里不重复。
6.2 在测试站上重置没效果
官方说明 indexables 在非生产环境和 staging 站点上不工作，重置也就看不到效果。
还有一种情况要留意：WordPress 用 WP_ENVIRONMENT_TYPE 常量标记站点环境，不设置时默认是 production。从测试站整站复制上线的正式站，wp-config.php 里可能还留着这样一行：
// 正式站把 staging 改成 production，或者整行删掉
define( 'WP_ENVIRONMENT_TYPE', 'staging' );正式站被标成了测试环境，Yoast 和其他插件都可能按非生产环境来处理。上线前检查一遍 wp-config.php，省得事后排查。
6.3 用过滤器禁用了 indexables
这是官方的第二条注意事项：如果在代码里用过滤器（filter）禁用了 Yoast indexables，重置不会生效，必须先把这个过滤器移除。
这类代码通常加在主题的 functions.php、mu-plugins 目录，或者 Code Snippets 这类代码片段插件里。有 SSH 的话，在网站根目录搜一下：
# 搜主题和 mu-plugins 目录里提到 indexables 的代码
grep -rn "indexables" wp-content/themes wp-content/mu-plugins代码片段插件的内容存在数据库里，要进插件后台逐条看。找到之后先注释掉或删除，再从第 5 步开始重做。
6.4 进度卡住、请求超时
内容多的站，常见原因是 PHP 内存或单次执行时间不够，也可能是安全插件、防火墙拦下了后台请求。前者在 VPS 上可以直接调，见第 7 节；后者先临时关掉安全插件试一次，跑完再打开。装了 Redis 这类对象缓存的，重置后清一次缓存再跑数据优化。
7. 在 VPS 上跑 WordPress 的额外建议
虚拟主机一般改不了 PHP 配置，VPS 可以，这也是老唐建议正经做站的朋友上 VPS 的原因之一。还没用过 VPS 的，可以先看《2026 VPS 新手入门教程：从购买到连接到建站完全指南》。
7.1 调大 PHP 内存和超时
php.ini 里这两项决定了单个 PHP 请求能用多少内存、跑多久：
; 单个请求可用的内存上限
memory_limit = 256M
; 单个请求最长执行时间，单位秒
max_execution_time = 300WordPress 自己也有内存上限，可以在 wp-config.php 里加一行：
// 放在 "That's all, stop editing!" 那一行之前
define( 'WP_MEMORY_LIMIT', '256M' );改完 php.ini 要重启 PHP-FPM，服务名里带版本号，按自己装的版本来。前面有 Nginx 的，fastcgi_read_timeout 太短也会把请求切断，可以一并调大。用宝塔面板的，在对应 PHP 版本的设置里改，不用手动找文件。
数据优化跑完后，这些值可以改回原来的水平。
7.2 用 WP-CLI 处理大站
Yoast SEO 自带 WP-CLI 命令，SSH 登录后用下面这条查看：
# 列出 Yoast SEO 提供的 WP-CLI 命令和参数说明
wp yoast --help在 SSH 里跑，不受浏览器和网页请求超时的限制，适合内容上万篇的站。具体有哪些子命令、各参数怎么用，以 --help 的输出为准。执行时用网站文件所属的用户，别直接用 root，免得生成的文件权限不对。
7.3 备份放到别的地方
VPS 上可以用 cron 定时导出数据库，再同步到另一台机器或对象存储。哪天要重置 indexables 或做别的数据库操作，手上随时有一份能恢复的备份。
8. FAQ
1、重置 indexables 会丢掉文章里填的 SEO 标题和描述吗？
不会。文章里填的 SEO 标题、描述这些设置存在文章自身的数据里，indexables 是从这些数据生成的汇总表。重置清掉的是汇总表，重跑数据优化会重新生成。保险起见，操作前照样备份数据库。
2、重置要多长时间？
点重置按钮本身很快，耗时的是第 7 步的数据优化，取决于文章数量和服务器性能。文章越多耗时越长，上万篇的站要有耐心，或者改用 WP-CLI。
3、Yoast Test Helper 用完需要删除吗？
建议停用并删除。它是 Yoast 官方出的测试辅助插件，用来做重置这类维护操作，正式站上不需要常驻，下次要用再装。
4、WordPress 版本低，能装 Yoast Test Helper 吗？
当前的 1.19 版本要求 WordPress 7.0 及以上，已测试到 7.1.4。版本低于 7.0 的站，先升级 WordPress 再装。
5、为什么在测试站、本地站上重置了也没用？
官方说明 indexables 在非生产环境和 staging 站点上不工作。正式站也要检查 wp-config.php 里 WP_ENVIRONMENT_TYPE 有没有被设成测试环境，另外确认没有用过滤器禁用 indexables。
6、能不能用 WP-CLI 代替后台按钮？
Yoast SEO 自带 WP-CLI 命令，wp yoast --help 能看到可用命令和参数。重置这一步，老唐建议按官方方法用 Yoast Test Helper；数据量大的站，重新生成那一步可以在 SSH 里按 --help 的说明来做。
9. 总结
Yoast 的 SEO 数据优化卡住或报错，按官方方法处理就三件事：装 Yoast Test Helper，在 Tools → Yoast Test 里点 Reset indexables tables & migrations，再到 Yoast SEO → Tools 点 Start data optimization 重新跑。动手前备份数据库，挑低峰期；做完看源代码里的 canonical 和站点地图，再把 Yoast Test Helper 删掉。
重置没效果时，先查两件事：站点是不是被当成了 staging 环境，代码里有没有禁用 indexables 的过滤器。报错就对照 Yoast 官方指南逐条排查。
老唐后面会接着写 WordPress 搬家、换域名之后的 SEO 收尾清单，把 Yoast 数据、站点地图和 Google Search Console 放在一起讲。
AD：WordPress 站放在 VPS 上，PHP 内存、超时都能自己调，WP-CLI 也随时能用。老唐推荐搬瓦工（点此购买），国内 SSH 管理和网站访问都比较顺畅，最新优惠见《2026年10月最新搬瓦工优惠码/搬瓦工便宜套餐/搬瓦工CN2 GIA方案推荐》。购买流程参考《2025 最新搬瓦工购买教程：新用户注册账户、选择套餐、支付宝付款》。
相关文章
- 《2026 VPS 新手入门教程：从购买到连接到建站完全指南》
- 《2025 最新搬瓦工购买教程：新用户注册账户、选择套餐、支付宝付款》
- 《2026年10月最新搬瓦工优惠码/搬瓦工便宜套餐/搬瓦工CN2 GIA方案推荐》
- 《2026 Google Colab CLI 入门：终端里一行命令调用 A100 / H100，免费的是 CLI 不是 GPU》
