WordPress多站点term_id重复导致分类标签编辑报错求助

核心问题定位 #

Term ID is shared between multiple taxonomies是WordPress 4.2版本完成术语拆分（term splitting）后的典型报错。该版本后WordPress不再允许不同分类法（标签、文章分类、自定义分类法）共享同一个term_id，一旦term_taxonomy表出现同一个term_id绑定多条不同taxonomy的记录，编辑/删除对应术语时就会被权限校验逻辑拦截，抛出“需要更高等级权限”的前端提示。
从已捕获的SQL语句和数据库数据对比看，传入的插入参数正确但实际写入值错误，问题出在数据库层写入逻辑被改写或者WordPress数据库抽象层被篡改两个方向，和WordPress核心代码逻辑无关。

分步排查流程 #

• 基准验证：直连MariaDB/MySQL，手动执行捕获到的两条INSERT语句，执行完成后查询term_taxonomy表的写入结果。
  • 若手动执行写入的term_id和传入参数一致，问题定位在WordPress应用层
  • 若手动执行依然写入错误的term_id，问题定位在数据库侧
• 数据库侧异常排查：
  执行SHOW TRIGGERS LIKE 'wp_62_term_taxonomy';查看该表绑定的触发器，90%以上的同类问题来自第三方插件/运维脚本添加的INSERT触发器——这类触发器通常为了实现术语slug去重、多站点术语共享功能，逻辑未兼容WordPress 4.2+的术语拆分规则，插入分类术语时会错误复用同名标签已有的term_id，导致脏数据写入。
  同时检查该表是否存在自定义外键约束、表级改写规则修改插入值。
• WordPress应用层异常排查：
  1. 检查wp-content目录下是否存在自定义db.php文件，这类文件是WordPress的数据库层替换入口，常见于缓存插件、数据库加速插件，部分低质量实现会在批量插入数据时复用前一次请求的参数，导致$wpdb->last_query记录的原始语句正确，但实际发往数据库的语句使用了错误的缓存参数。
  2. 临时禁用所有插件、切换到官方默认主题，重新测试创建同名标签和分类的流程，如果问题不复现，逐个启用插件定位冲突点，重点排查术语管理、SEO优化、多站点共享、数据库优化类插件——这类插件常通过wp_insert_term、query等钩子修改术语插入逻辑，仅按名称/slug匹配术语就复用term_id，未做分类法维度的校验，直接触发冲突。

修复方案 #

• 临时业务恢复：先清理已存在的脏数据，以给出的示例数据为例，执行如下SQL修正错误绑定的记录：

UPDATE wp_62_term_taxonomy SET term_id = 107692 WHERE term_taxonomy_id = 35;

批量定位异常记录可执行如下语句：

SELECT term_id, COUNT(*) as cnt FROM wp_62_term_taxonomy GROUP BY term_id HAVING cnt > 1;

对照wp_62_terms表中同名术语的独立term_id，逐一修正关联关系即可恢复术语的编辑/删除功能。

• 根因永久修复：
  • 定位到异常触发器/自定义db逻辑/冲突插件后，直接删除不兼容的代码，停用存在bug的插件，替换为支持WordPress 4.2+术语拆分规则的实现。
  • 给wp_62_term_taxonomy表的term_id字段添加唯一索引，从数据库层面阻止跨分类法复用term_id的脏数据写入，后续如果有错误逻辑尝试插入重复term_id，会直接触发数据库报错，不会产生脏数据影响用户使用，索引创建语句如下：

ALTER TABLE wp_62_term_taxonomy ADD UNIQUE INDEX `uniq_term_id` (`term_id`);

内容的提问来源于stack exchange，提问作者Aaron A