Чёрный фон появляется, когда 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 занимает несколько пикселей
- Подготовить маленький fixture с прозрачным углом, полупрозрачной тенью и непрозрачным цветом.
- Пропустить его через оригинальный upload и resize pipeline.
- Сравнить alpha и RGB контрольных пикселей до и после.
- Открыть результат на белом и тёмном фоне.
- Повторить для PNG-выхода и осознанного JPEG flatten.
- Проверить публичный URL через CDN и origin отдельно.
Для диагностики достаточно безопасного fixture
Подготовьте минимальный искусственный PNG, код создания destination, формат вывода, версии PHP/GD и заголовки origin/CDN. Реальные фотографии товаров не нужны. Если fixture проходит, а один файл нет, сравнивают цветовой тип, bit depth и metadata этого исходника.