Картинка для соцсетей генерируется, но превью ссылки остаётся пустым

Почему так происходит

Генератор запекается в файл без расширения. Веб-сервер отдаёт его как поток байтов, а соцсети и ассистенты принимают картинку только с типом image/*. Сама картинка при этом корректная — её можно скачать и открыть.

Что делать

Либо дописать тип на веб-сервере, либо не генерировать картинку маршрутом, а положить готовый файл с расширением в статику и сослаться на него в метаданных. Второе не зависит от настройки сервера.

Как убедиться, что дело именно в этом

Посмотреть, что реально лежит в каталоге экспорта: имя файла без точки и расширения — это и есть диагноз.

Чем это кончается, если не заметить

Каждая расшаренная ссылка выглядит пустым прямоугольником, хотя в разметке og:image присутствует и валидаторы разметки довольны.