Чёрный фон появляется, когда pipeline потерял alpha-канал или заранее скомпоновал изображение с чёрным destination. Прозрачность — отдельная компонента пикселя; расширение .png само по себе её не восстанавливает. Сравните исходный файл и результат до просмотра в интерфейсе сайта.

Сначала решите, нужен ли прозрачный выход. PNG, WebP и AVIF могут хранить alpha, JPEG — нет. Для JPEG фон выбирают явно: белый, цвет карточки или другой согласованный цвет. Не полагайтесь на случайный нулевой цвет нового холста.

Место потери определяется тремя файлами

ФайлAlpha естьВывод
ОригиналНетПроблема возникла до сервера
ОригиналДа, промежуточный нетДекодер или операция flatten
ПромежуточныйДа, финальный нетНеверные настройки encoder
Финальный PNGДа, viewer чёрныйПроверить фон viewer/CDN и MIME
Финальный JPEGНеприменимоНужно явное компонирование с фоном

PNG-спецификация описывает alpha от полностью прозрачного до полностью непрозрачного и формулу композиции с фоном. У полностью прозрачного пикселя RGB может быть чёрным; нормальный viewer его не показывает. Если alpha отброшен, скрытый RGB становится видимым чёрным.

PHP GD готовит destination до ресайза

$src = imagecreatefrompng($input);
$dst = imagecreatetruecolor($width, $height);

imagealphablending($dst, false);
imagesavealpha($dst, true);
$clear = imagecolorallocatealpha($dst, 0, 0, 0, 127);
imagefill($dst, 0, 0, $clear);

imagecopyresampled($dst, $src, 0, 0, 0, 0,
  $width, $height, imagesx($src), imagesy($src));
imagepng($dst, $output);

Документация PHP указывает, что для сохранения полного alpha blending следует отключить и вызвать imagesavealpha осознанно. Настройка применяется к destination image. Если после других операций режим смешивания менялся, зафиксируйте его рядом с кодом конкретной композиции.

Flatten для JPEG является отдельной операцией

Для непрозрачного результата создайте холст с выбранным RGB-фоном, включите ожидаемое смешивание и наложите PNG. Цвет берётся из дизайна, а не из пикселя (0,0). Такой результат тестируется на белом и тёмном интерфейсе, чтобы светлая окантовка или чёрный ореол не появились из-за неверно подготовленного alpha.

Premultiplied alpha выдаёт цветную кайму

Некоторые библиотеки временно хранят RGB уже умноженным на alpha, а PNG использует непредумноженное представление. Неверное преобразование чаще даёт тёмные края вокруг полупрозрачных пикселей, а не ровный прямоугольник. Не исправляйте такую кайму повторным удалением фона — проверьте модель alpha на границе.

  • Угол изображения должен оставаться полностью прозрачным.
  • Мягкая тень содержит промежуточные alpha, а не только 0 и 1.
  • Непрозрачный центр сохраняет исходный RGB.
  • Resize не превращает прозрачный край в чёрный ореол.
  • CDN отдаёт image/png и не подменяет формат оптимизатором.

Формат проверяется по байтам и заголовку

Не доверяйте одному имени файла. Сервис мог записать JPEG-байты под .png, а CDN — вернуть HTML ошибки с Content-Type image/png. Сохраните MIME, размер, сигнатуру файла и параметры encoder для одного request_id. Это локализует слой без публикации пользовательского изображения в логах.

Контрольный PNG занимает несколько пикселей

  1. Подготовить маленький fixture с прозрачным углом, полупрозрачной тенью и непрозрачным цветом.
  2. Пропустить его через оригинальный upload и resize pipeline.
  3. Сравнить alpha и RGB контрольных пикселей до и после.
  4. Открыть результат на белом и тёмном фоне.
  5. Повторить для PNG-выхода и осознанного JPEG flatten.
  6. Проверить публичный URL через CDN и origin отдельно.

Для диагностики достаточно безопасного fixture

Подготовьте минимальный искусственный PNG, код создания destination, формат вывода, версии PHP/GD и заголовки origin/CDN. Реальные фотографии товаров не нужны. Если fixture проходит, а один файл нет, сравнивают цветовой тип, bit depth и metadata этого исходника.

Проверенные источники