☰
WORDPRESS / PRACTICE

Как очистить orphaned taxonomy relationships в WordPress

Как очистить orphaned taxonomy relationships в WordPress

После импорта контента, массового удаления записей, миграции или аварийного восстановления базы данных WordPress в таблице wp_term_relationships могут остаться связи с объектами, которых больше нет в wp_posts. Такие строки называют orphaned taxonomy relationships, или «сиротскими» связями.

Они не всегда сразу вызывают заметную ошибку, но могут искажать счётчики категорий и тегов, усложнять обработку таксономий и создавать некорректные результаты при работе плагинов или собственных запросов. Ниже рассмотрен безопасный порядок проверки, очистки и повторного подсчёта терминов.

Что такое orphaned-связи в WordPress

WordPress хранит назначения категорий, тегов и пользовательских таксономий в таблице wp_term_relationships. В ней есть как минимум два важных поля: object_id — идентификатор записи или другого объекта, и term_taxonomy_id — идентификатор термина в конкретной таксономии.

Связь считается orphaned, если её object_id больше не соответствует ни одной записи в wp_posts. Например, запись могли удалить без корректной очистки связанных строк или восстановить из резервной копии только часть таблиц.

В wp_posts хранятся не только обычные записи блога. В этой таблице также находятся страницы, вложения и записи пользовательских типов. Поэтому проверка через wp_posts охватывает все стандартные объекты, которые могут иметь таксономии.

  • неправильные или несвоевременно обновлённые счётчики терминов;
  • лишние строки в базе данных после импорта или массового удаления;
  • некорректная работа архивов таксономий или плагинов, которые напрямую читают связи;
  • более медленные запросы к таксономиям на крупных сайтах.

Подготовка: резервная копия и проверка префикса

Очистка выполняется непосредственно в базе данных, поэтому перед изменениями обязательно создайте актуальный дамп. Резервная копия должна быть доступна для восстановления, а не просто успешно сформирована на сервере.

В примерах ниже используется префикс wp_. На конкретном сайте он может быть другим, например abc_ или site1_. Не подставляйте wp_ наугад: неправильный префикс приведёт к ошибке или проверке не той таблицы.

Текущий префикс можно проверить в конфигурации WordPress или через WP-CLI, если эта команда доступна в вашей среде.

  • выполняйте команды из корневой директории нужного WordPress-сайта;
  • убедитесь, что WP-CLI подключается именно к нужной базе данных;
  • для multisite проверьте, к какому сайту и набору таблиц относится операция;
  • перед очисткой предупредите команду или клиента о коротком техническом обслуживании, если сайт активно изменяет данные.
wp db export before-taxonomy-cleanup.sql

Как найти orphaned taxonomy relationships

Сначала нужно получить количество связей, которые ссылаются на отсутствующие записи. LEFT JOIN оставляет в результате строки из wp_term_relationships, для которых соответствующая запись в wp_posts не найдена. Условие p.ID IS NULL отбирает именно такие случаи.

Замените wp_ на фактический префикс таблиц и выполните запрос через WP-CLI.

wp db query "
SELECT COUNT(*) AS orphaned_relationships
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"

Дополнительная проверка перед удалением

Если количество не равно нулю, не спешите сразу удалять строки. Сначала просмотрите несколько примеров и убедитесь, что это действительно связи с несуществующими объектами, а не ошибка в названии таблицы или подключение к другой базе данных.

wp db query "
SELECT tr.object_id, tr.term_taxonomy_id
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL
LIMIT 50;
"

Как безопасно удалить «сиротские» связи

После проверки можно удалить только те строки wp_term_relationships, для которых не существует соответствующей записи в wp_posts. Запрос не удаляет записи, термины, таксономии или медиафайлы — он убирает только некорректные связи.

Для MySQL и MariaDB используется DELETE с JOIN. Выполняйте его только после создания резервной копии и повторной проверки префикса таблиц.

  • не расширяйте условие без понимания последствий;
  • не удаляйте все строки конкретной таксономии, если проблема касается только несуществующих object_id;
  • если сайт продолжает импорт или массовое удаление, сначала остановите эти процессы, чтобы данные не менялись во время очистки.
wp db query "
DELETE tr
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"

Что делать, если команда возвращает ошибку

Наиболее частые причины — неправильный префикс, недостаточные права пользователя базы данных или другой тип СУБД. Проверьте подключение командой wp db cli или сначала выполните безопасный SELECT-запрос. Не заменяйте DELETE альтернативной массовой очисткой таблицы.

Пересчёт категорий, тегов и пользовательских таксономий

После удаления orphaned-связей стоит пересчитать счётчики терминов. Это помогает синхронизировать сохранённые значения count с фактическим количеством связанных объектов.

Для стандартных таксономий используйте команды WP-CLI:

wp term recount category
wp term recount post_tag

Пользовательские таксономии

Для пользовательской таксономии укажите её системный slug, а не название, которое видит пользователь в административной панели. Например, если таксономия зарегистрирована со slug product_brand, команда будет выглядеть так:

wp term recount product_brand

Проверка результата после очистки

После DELETE повторите исходный SELECT. В нормальной ситуации он должен вернуть ноль. Если orphaned-связи появились снова, проблема может быть не в разовом повреждении данных, а в импорте, плагине или собственном коде, который создаёт связи без проверки существования записи.

Также проверьте несколько архивов категорий и тегов, страницы записей и работу поиска. На сайтах с пользовательскими типами записей отдельно просмотрите соответствующие архивы.

Отдельно убедитесь, что после очистки не исчезли легитимные связи. Запрос удаляет только строки, для которых отсутствует object_id в wp_posts, поэтому существующие записи и их таксономии он не должен затронуть.

  • повторно выполнить COUNT-запрос;
  • проверить счётчики терминов в нужных таксономиях;
  • просмотреть страницы архивов и несколько записей с категориями и тегами;
  • проверить журналы импортера, если проблема возникла после импорта.
wp db query "
SELECT COUNT(*) AS orphaned_relationships
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"

Типичные ошибки при очистке

Самая опасная ошибка — выполнить массовое удаление без резервной копии или использовать неправильный префикс. Ещё одна распространённая проблема — путать orphaned-связи с «сиротскими» терминами. В этом материале речь идёт об отсутствующих записях в wp_posts. Если нужно проверить термины, для которых нет соответствующей строки в wp_terms или wp_term_taxonomy, это уже другая диагностика.

Не следует вручную удалять строки из wp_posts или wp_terms, чтобы исправить счётчики. Так можно потерять контент или структуру таксономий. Сначала определите, какой именно тип несоответствия присутствует в базе данных.

Также не стоит считать любой ненулевой результат доказательством серьёзной ошибки сайта. Некоторые плагины или нестандартные процессы могут временно изменять данные. Важны контекст появления строк и повторная проверка после очистки.

  • не используйте TRUNCATE для wp_term_relationships;
  • не редактируйте базу во время активного импорта или миграции;
  • не запускайте команду для продакшна, если WP-CLI подключён к staging или другой базе данных;
  • храните дамп до момента, когда убедитесь, что сайт работает корректно.

Частые вопросы

Можно ли удалять orphaned-связи без резервной копии?

Технически запрос может выполниться, но делать это без резервной копии не стоит. Ошибка в префиксе, базе данных или SQL-условии может привести к потере данных, а дамп позволит быстро восстановить предыдущее состояние.

Удалит ли этот запрос сами записи или категории?

Нет. Запрос удаляет только строки из wp_term_relationships, которые ссылаются на object_id, отсутствующий в wp_posts. Записи, термины и таксономии он не удаляет.

Почему после очистки счётчики категорий остались неправильными?

Нужно выполнить wp term recount для соответствующих таксономий. Если проблема сохраняется, проверьте другие типы повреждённых данных, кеширование, фильтры плагинов или процесс, который повторно создаёт некорректные связи.

Относится ли проверка к вложениям и пользовательским типам записей?

Да. Вложения и записи пользовательских типов обычно также хранятся в wp_posts, поэтому LEFT JOIN по object_id охватывает их. Однако результаты следует интерпретировать с учётом логики конкретных плагинов.

Вывод

Очистка orphaned taxonomy relationships — это точечная операция для удаления связей с записями, которых больше нет в базе данных. Безопасный порядок действий таков: создать дамп, проверить префикс, подсчитать «сиротские» строки, просмотреть примеры, выполнить ограниченный DELETE и повторно проверить результат.

После этого пересчитайте термины через WP-CLI и проверьте архивы сайта. Если некорректные связи появляются снова, ищите причину в импорте, миграции, плагине или собственном коде, а не запускайте очистку без анализа каждый раз.

← Все материалы WordPress