VK строит карточку не из того DOM, который вы видите после работы браузерного JavaScript, а из данных, доступных его загрузчику. Поэтому начните с сырого ответа. Если `og:image` появляется только после hydration, закрыт геоблоком или ведёт на HTML вместо картинки, ручная перепубликация ссылки ничего не исправит.
Симптом «нет превью» и симптом «старое превью» требуют разного первого действия. При пустой карточке ищут сбой получения или разметки. При старой — сначала убеждаются, что новый HTML уже доступен извне, и только затем сбрасывают кеш конкретного адреса.
Каскад останавливается на первом неуспешном ответе
| Шаг | Проверка | Типичная поломка |
|---|---|---|
| Страница | 200 после допустимых redirect | 403, login, bot protection |
| HTML head | og:title, og:type, og:url, og:image | Теги только в JavaScript |
| Изображение | 200, image/*, разумный размер | HTML error под URL картинки |
| Канонический URL | og:url соответствует странице | Все карточки указывают на главную |
| Кеш VK | Обновление после починки | Сохранена старая карточка |
Open Graph находится в исходном head
<meta property="og:title" content="Как выбрать тариф">
<meta property="og:type" content="article">
<meta property="og:url" content="https://example.com/blog/tariff/">
<meta property="og:image" content="https://cdn.example.com/og/tariff.jpg">
<meta property="og:image:type" content="image/jpeg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Таблица сравнения тарифов">
<meta property="og:description" content="Короткое сравнение условий без скрытых доплат.">Open Graph определяет четыре базовых свойства: title, type, image и url. Остальные помогают описать объект и изображение. Используйте абсолютные адреса. Если тег повторяется, протокол отдаёт предпочтение первому значению сверху, поэтому конфликтующий блок плагина может выигрывать у нового.
URL картинки проверяется как отдельный ресурс
- Откройте точный og:image без cookies, Referer и авторизации.
- Проверьте конечный HTTP status после redirect и корректный `Content-Type: image/...`.
- Убедитесь, что TLS-сертификат действителен и цепочка не возвращается на HTTP.
- Не отдавайте hotlink-заглушку ботам и внешним площадкам.
- Не ставьте изображение за одноразовой signed URL, которая скоро истечёт.
- Укажите ширину, высоту, тип и alt рядом с тем же корневым og:image.
Проверка изображения в обычном браузере может быть ложноположительной: браузер уже авторизован или хранит кеш. Нужен чистый внешний запрос. Если CDN преобразует формат по Accept, проверьте, что неизвестный клиент получает обычный поддерживаемый image response, а не страницу ошибки.
Пустая карточка отличима от старой
| Наблюдение | Вероятный слой | Что делать |
|---|---|---|
| Нет title и image | Страница недоступна/нет OG | Page response и source |
| Title новый, image нет | Image fetch | Status, MIME, redirect |
| Всё старое | Кеш или старый origin HTML | Сравнить source, затем clear cache |
| У всех URL одна карточка | Неверный og:url/шаблон | Данные страницы в head |
| Работает только с ?v=2 | Кеш маскирует проблему | Обновить origin и точный URL |
Кеш очищают после исправления источника
В API VK существует метод `pages.clearCache` для внешних страниц, прикрепляемых к публикациям. Используйте его в соответствии с актуальной документацией и правами приложения, передавая точный URL без токена в логах или статье. Если кеш очистить раньше, VK снова сохранит тот же неправильный HTML.
- Получить свежий HTML страницы и убедиться, что новые OG-теги уже опубликованы.
- Получить картинку внешним запросом и записать status, MIME и конечный URL.
- Сверить og:url с адресом, который пользователи вставляют в VK.
- Очистить кеш этого URL официальным методом или инструментом аккаунта.
- Создать одну тестовую публикацию и сравнить заголовок, изображение и описание.
- Не менять URL массово, пока один контрольный адрес не работает стабильно.
Результат принят, когда внешний клиент получает корректный HTML и изображение без сессии, OG относится к конкретной странице, а после обновления кеша VK формирует ожидаемую карточку. Для разбора нужны source head, два набора response headers и точный URL без персональных параметров.