AEM Dynamic Media: PNG-Transparenz wird als weißer Hintergrund angezeigt

Letzte Aktualisierung: 11. August 2026

In diesem Artikel wird beschrieben, wie Sie Probleme beheben können, bei denen PNG-Bilder mit transparentem Hintergrund in Adobe Experience Manager Dynamic Media mit einem weißen Hintergrund statt mit Transparenz angezeigt werden.

Beschreibung description

Umgebung

Adobe Experience Manager (AEM) Dynamic Media (alle Versionen)

Symptome

PNG-Bilder mit transparentem Hintergrund werden in das DAM hochgeladen und erscheinen in der Asset-Vorschau transparent.
Wenn diese Bilder auf Web-Seiten verwendet werden oder über direkte Versand-URLs aufgerufen wird, wird die Transparenz durch einen weißen Hintergrund ersetzt.
Die Verwendung des fmt=png-alpha-Parameters in der Versand-URL behebt das Problem in einigen Fällen nicht.
Es werden keine Fehlermeldungen angezeigt. Das Problem besteht beim Rendern von Bildern.

Ursache

Standardmäßig gibt Dynamic Media Bilder mit einem undurchsichtigen Hintergrund zurück, es sei denn, die Transparenz wird explizit mit fmt=png-alpha angefordert. Wenn dieser Parameter fehlt oder nicht richtig konfiguriert ist, wird der Hintergrund weiß angezeigt.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Stellen Sie sicher, dass die Bildbereitstellungs-URL den fmt=png-alpha enthält, um PNG explizit mit Alpha-Transparenz anzufordern.
Wenn Sie eine Bildvorgabe verwenden, überprüfen Sie, ob die Vorgabe für die Ausgabe von PNG mit Alpha-Transparenz konfiguriert ist. Aktualisieren Sie die Voreinstellung, falls erforderlich, um fmt=png-alpha einzuschließen.
Löschen Sie nach dem Aktualisieren von URLs oder Vorgaben den Browser-Cache und alle CDN-Cache, um sicherzustellen, dass das neueste Bild bereitgestellt wird.
Betten Sie das Bild in eine HTML-Basisseite ein, um zu bestätigen, dass die Transparenz außerhalb der AEM-Benutzeroberfläche korrekt gerendert wird. Wenn die Transparenz hier korrekt angezeigt wird, kann das Problem mit den CSS- oder Hintergrundeinstellungen der Seite bestehen.
Überprüfen Sie die ImageServer-Einstellungen. Wenn Transparenz nicht explizit angefordert wird, gibt ImageServer standardmäßig Bilder mit einer opaken Hintergrundfarbe zurück (der Standardwert ist weiß). Aktualisieren Sie die Anfrage oder Voreinstellung, um sicherzustellen, dass immer Transparenz für Assets angefordert wird, für die sie erforderlich ist.

Nachdem Sie diese Schritte ausgeführt haben, überprüfen Sie, ob die PNG-Transparenz auf Ihren Web-Seiten korrekt angezeigt wird.

recommendation-more-help

experience-cloud-kcs-help-kbarticles