So importieren Sie Produkte in Magento 2 im 2026: Der Arbeitsleitfaden für 2.4.8 - DEUTSCH

Adobe hat Magento ausgeliefert 2.4.8 am April 8, 2025, und die Art und Weise, wie sich große Kataloge über die Plattform bewegen, hat endlich aufgeholt 2026. Die nativen REST-Importendpunkte (/V1/import/csv und /V1/import/json) Akzeptiert jetzt Base64-codierte Nutzlasten und GZIP-Komprimierung. Das tötet die Alten “Teilen Sie Ihre CSV auf 500 Reihen und beten” Routine. Der Admin-CSV-Importer, auf den sich die meisten Geschäfte immer noch stützen? Gleiches Werkzeug, meistens. Aber die Art und Weise, wie es bricht, hat sich verändert, und so auch die Korrekturen. Dieser Leitfaden deckt beide Wege ab, und die Fehler, die ein Wochenende verschlingen, wenn man sie vermisst.

Schnelle Antwort: Für Kataloge unter 5,000 SKUs, Verwenden Sie den Admin-CSV-Importer unter System > Datentransfer > Importieren. Für alles, was größer oder automatisiert ist, Schlagen Sie die REST /V1/import/csv-Endpunkt hinzugefügt 2.4.8. Behalten Sie UTF-8-Dateien ohne Stückliste bei, Bilder hineinlegen var/import/images, und immer laufen “Daten überprüfen” bevor Sie sich verpflichten.

Zuletzt überprüft: April 2026. Endpunkte, Versionsnummern, und Importverhalten, das anhand von Adobe Commerce überprüft wurde 2.4.8 Versionshinweise und die Experience League-Dokumentation.

Bevor Sie beginnen: Was sich geändert hat 2.4.8

Wenn Sie Produkte auf Magento importiert haben 2.4.5 oder früher, ein paar Ausfälle haben die Realität eingeholt. Neu 2.4.8 Installiert das Schiff mit den Indexern Aktualisierung nach Zeitplan Modus, Dadurch kommt es bei Massenimporten nicht mehr dazu, dass das Frontend während der Neuindizierung zum Stillstand kommt. Die Veröffentlichung wurde geschlossen 497 Kernfehler (mehrere auf dem Importeur selbst) und fügte die REST-Importendpunkte hinzu, die die 2-MB-Upload-Obergrenze für Administratoren umgehen.

Folgendes müssen Sie vor Ort haben, bevor Sie sich an den Importeur wenden:

• Magento 2.4.8 oder später. Läuft 2.4.5 oder älter? Aktualisieren Sie zuerst. Der ältere Importer funktioniert immer noch, aber Fehlerbehebungen werden nicht zurückportiert.
• PHP 8.3 Minimum, 8.4 empfohlen. 2.4.8 wird mit nativem PHP geliefert 8.4 Unterstützung. Speichert auf PHP 8.1 wird importieren, aber die Fehlerbehandlung ist lauter.
• MySQL 8.0 oder MariaDB 10.6/11.4. 2.4.9-Beta1 lässt MySQL fallen 8.0 und MariaDB 10.6, also, wenn Sie neu einrichten, gehen 11.4.
• Ein beschreibbares var/import/images-Verzeichnis. Berechtigungen: 775 für Verzeichnisse, 664 für Dateien, Eigentum Ihres Webbenutzers.
• Ausreichende PHP-Limits. Für Kataloge vorbei 10,000 SKUs, speicher_limit 2G und max_execution_time 1800 in php.ini. Niedrigere Werte führen dazu, dass Importe zwischenzeitlich stillschweigend zum Erliegen kommen.

Eine kurze Vorwarnung: Adobe Commerce (die bezahlte Stufe) und Magento Open Source teilen sich den Importercode. Cloud-Kunden müssen php.ini nicht berühren, da der Stack bereits voreingestellt ist, Die folgenden CSV-Regeln und Verhaltensweisen gelten jedoch identisch.

Was Sie tatsächlich importieren können

Magento 2 verfügt über sechs Produkttypen, und die CSV-Regeln ändern sich je nachdem, welches Sie verschieben. Die Kurzversion:

• Einfache Produkte. Eine SKU, eine Variante. Die Vorlage, die jedes Tutorial verwendet. Importieren Sie diese zuerst, wenn Sie lernen.
• Konfigurierbare Produkte. Eine übergeordnete SKU mit untergeordneten Simples, die über angehängt sind konfigurierbare_Variationen. T-Shirts in Größe und Farbe sind das Musterbeispiel. Untergeordnete Elemente müssen vor der übergeordneten Importzeile vorhanden sein, oder der Link schlägt fehl.
• Virtuelle Produkte. Dienstleistungen, Abonnements, Garantieabdeckung. Keine Versandkostenberechnung, keine Gewichtssäule erforderlich.
• Gruppierte Produkte. Ein Wrapper, der mehrere Simples auf einer Seite anzeigt (denken “Küchenmesserset, einzeln kaufen”). Verwendet assoziierte_skus in der CSV.
• Gebündelte Produkte. Erstellen Sie Ihre eigenen Kombinationen, bei denen der Kunde Optionen auswählt. Das Format ist umständlich und benutzerfreundlich bundle_values mit durch Rohre getrennten Feldern.
• Herunterladbare Produkte. Dateien, Softwarelizenzen, E-Books. Bedürfnisse herunterladbare_Links konfiguriert.

Wichtig ist die Importreihenfolge. Simples zuerst, dann konfigurierbare Elemente, die auf sie verweisen, dann gruppiert und zuletzt gebündelt. Das Importieren einer konfigurierbaren Komponente, deren untergeordnete SKUs noch nicht vorhanden sind, ist der häufigste selbstverschuldete Fehler, und der Validator wird es nicht immer erkennen, bevor der Import ausgeführt wird.

CSV-Import: Die Admin-Komplettlösung

Der Admin-CSV-Importer verarbeitet Kataloge bis zu ca 5,000 Artikel ohne Beanstandung. Wissenswert, auch wenn Sie später auf die API umsteigen möchten, denn die folgenden Spaltenregeln gelten für beide Pfade.

Schritt 1: Exportieren Sie eine Beispieldatei (Überspringen Sie das nicht)

Gehe zu System > Datentransfer > Importieren. Satz Entitätstyp zu Produkte, dann klick Beispieldatei herunterladen. Das Beispiel entspricht genau Ihrer Magento-Installation, einschließlich aller benutzerdefinierten Attribute, die Ihr Shop hinzugefügt hat. Durch die Verwendung einer generischen CSV-Vorlage aus einem Blog-Beitrag entstehen Fehler aufgrund von Spaltenkonflikten.

Speichern Sie die Probe, Öffnen Sie es in Notepad++ oder VS Code. Verwenden Sie nicht Microsoft Excel. Excel fügt UTF-8-Dateien eine Byte-Reihenfolgemarkierung hinzu, und der Importer lehnt Dateien mit Stücklistenpräfixen ohne eindeutige Fehlermeldung ab. Wenn Excel Ihre einzige Option ist, exportieren als “CSV UTF-8” und führen Sie die Datei über einen Stücklisten-Entferner aus, oder wechseln Sie zu Google Sheets (Datei > Herunterladen > CSV, was sauberes UTF-8 spart).

Schritt 2: Füllen Sie Ihre Produktzeilen aus

Erforderliche Spalten für ein einfaches Produkt: SKU, store_view_code, attribute_set_code, Produkttyp, Kategorien, Produktwebsites, Name, Beschreibung, Preis, Menge, Gewicht, produkt_online, Steuerklassenname, Sichtweite.

Behalten Sie die Beschreibungen unten bei ~255 Zeichen pro Zeile, wenn Sie sich im Admin-Importer befinden. Längere HTML-Beschreibungen funktionieren, Aber sie erhöhen die Dateigröße schnell und bringen die Standardgrenze von 2 MB näher. Kategorien verwenden Schrägstriche, um eine Hierarchie aufzubauen: Standardkategorie/Bekleidung/T-Shirts. Das Trennzeichen ist ein Schrägstrich, kein Backslash. Eine Erleichterung: Magento erstellt automatisch Kategoriepfade, die noch nicht existieren, Sie müssen also nicht jede Kategorie vor dem Import vorab erstellen.

Für Konfigurierbare, das konfigurierbare_Variationen Die Spalte enthält eine durch Pipes getrennte Zeichenfolge wie:
sku=SHIRT-ROT-S,Größe=S,Farbe=Rot|sku=SHIRT-ROT-M,Größe=M,Farbe=Rot

Knifflig, Ja. Sparen Sie sich den Aufwand, indem Sie zunächst eine von Hand erstellte konfigurierbare Datei exportieren, Verwenden Sie dann diese Zeile als Vorlage für die nächste 5,000.

Schritt 3: Konfigurieren Sie das Importverhalten

Was passiert, wenn eine SKU in Ihrer CSV-Datei bereits im Katalog vorhanden ist?? Drei Verhaltensoptionen entscheiden, und wenn man das Falsche auswählt, können Daten gelöscht werden:

• Hinzufügen/Aktualisieren. Die Standard- und die sichere Auswahl. Fügt neue SKUs hinzu, aktualisiert passende, lässt nicht gelistete Produkte in Ruhe.
• Ersetzen. Löscht zuerst übereinstimmende SKUs, erstellt sie dann aus der CSV neu. Löscht URLs, Bewertungen, und Bestandsbewegungsverlauf dieser Produkte. Selten verwenden.
• Entitäten löschen. Entfernt passende SKUs aus dem Katalog. Ohne Datenbankwiederherstellung irreversibel.

Auch eingestellt Feldtrennzeichen zum Komma, Trennzeichen für mehrere Werte zum Komma, und prüfen Anzahl der zulässigen Fehler. Standard ist 10. Erhöhen Sie den Wert auf eine höhere Zahl, wenn Sie damit rechnen, dass einige Zeilen fehlschlagen, und möchten, dass der Importer weitermacht, statt abzubrechen.

Schritt 4: Vor dem Import validieren

Laden Sie Ihre CSV-Datei hoch, klicken Daten überprüfen, und warte. Dadurch wird die gleiche Validierung ausgeführt wie beim echten Import, aber ohne in die Datenbank zu schreiben. Die Ausgabe listet jeden Zeilenfehler nach Nummer mit der spezifischen Spalte auf, die fehlgeschlagen ist. Korrigieren Sie die CSV, erneut hochladen, noch einmal prüfen. Spülen, bis es grün ist.

Wenn die Validierung sagt “Datei ist gültig” Es werden jedoch einige Warnungen angezeigt, lies sie trotzdem. Bei Warnungen handelt es sich häufig um fehlende Kategoriepfade oder Store-Ansichten, die Magento stillschweigend überspringt, Erstellen von Produkten mit unvollständigen Kategoriebäumen.

Schritt 5: Führen Sie den Import aus

Klicken Importieren. Der Fortschrittsbalken ist für kleine Dateien ehrlich und für große optimistisch. Schließen Sie den Browser-Tab nicht. Nicht aktualisieren. Der Importer führt einen einzelnen langen PHP-Prozess aus, und auf langsamerem Hosting, Wenn Sie die Registerkarte während des Schreibvorgangs schließen, wird der Vorgang verwaisen und Teildaten bleiben zurück. Betrachten var/log/import.log über SSH, wenn Sie Live-Fortschritt wünschen, oder überprüfen System > Historie importieren sobald es fertig ist.

Bilder und Medien

Bilder verwirren mehr Importe als jedes andere Feld. Die Regel ist einfach, wenn man sie einmal gesehen hat.

FTP oder SFTP Ihre Bilddateien in <Magento-Root>/var/import/images. Unterordner sind erlaubt: var/import/images/2026-spring funktioniert. In der CSV, Verweisen Sie auf jedes Bild anhand seines relativen Pfads var/import/images:

• base_image Säule: Hauptproduktbild (auf der Produktseite angezeigt)
• small_image Säule: Miniaturansicht für Kategorieseiten
• Miniaturbild Säule: Warenkorb und Miniaturansichten bestellen
• zusätzliche_bilder Säule: Galeriebilder, durch Kommas getrennt

So könnte eine Zeile aussehen, in der ein Produkt mit vier Galerieaufnahmen importiert wird: /2026-spring/tshirt-red-main.jpg im base_image, dann /2026-spring/tshirt-red-back.jpg,/2026-spring/tshirt-red-detail.jpg,/2026-spring/tshirt-red-fabric.jpg im zusätzliche_bilder.

Achten Sie auf die Dateibenennung. Magento-Leckereien Shirt.jpg und hemd.jpg als verschiedene Dateien auf Linux-Hosts, und der Importer korrigiert die Groß-/Kleinschreibung nicht automatisch. Wenn möglich, vor dem Hochladen auf WebP komprimieren; Hero-Shots im JPEG-Format mit 300–400 KB tanken Ihre Core Web Vitals in dem Moment, in dem es zu echtem Datenverkehr kommt. Unser Magento-Geschwindigkeits-Playbook deckt die WebP- und AVIF-Konvertierung für bestehende Kataloge ab.

REST-API-Import: Das 2.4.8 Pfad für große Kataloge

Der Admin-Importer erreicht schnell seine Grenzen. Sobald du vorbei bist 10,000 SKUs oder Sie benötigen automatisierte Synchronisierungen von einem ERP, die von Adobe gelieferten REST-Endpunkte 2.4.8 sind das richtige Werkzeug. Zwei Endpunkte sind wichtig:

• POST /ruhe/<store_code>/V1/import/csv für CSV-Nutzlasten
• POST /ruhe/<store_code>/V1/import/json für JSON-Nutzlasten

Beide akzeptieren eine Base64-codierte Zeichenfolge im Anforderungstext. Für CSV, Die Regel ist: UTF-8 kodieren Sie Ihre Datei, gzip-komprimieren Sie es (optional, aber sinnvoll für alles über 1 MB), dann base64 das Ergebnis. Die Antwort gibt die Anzahl der importierten Entitäten zurück. Asynchroner Bulk per /V1/Bulk/ Funktioniert auch, wenn Sie Fire-and-Forget wollen.

Der Fluss, in Ordnung:

• Authentifizieren Sie sich mit einem Admin-Token (POST an /V1/integration/admin/token)
• Komprimieren Sie Ihre Produkte.csv, Base64-kodieren Sie es, stopfen Sie es in eine JSON-Nutzlast mit Quelle, juristische Person: “Katalogprodukt”, und Verhalten: “anhängen”
• POST an den Importendpunkt mit dem Token im Authorization-Header
• Umfrage /V1/Bulk/{bulkUuid}/Status wenn Sie asynchron gegangen sind

Die Entwicklerdokumente von Adobe enthalten die genaue Nutzlastform und das Update pro Version, Ziehen Sie also von dort, anstatt alte StackOverflow-Threads zu kopieren. Das 2.4.8 auszahlen: Der asynchrone Pfad hält eine PHP-Anfrage bis zu nicht offen 30 Minuten, wie es der Admin-Importer tut. Ihr 50.000-Zeilen-Ladevorgang läuft im Hintergrund, und die Storefront reagiert weiterhin auf tatsächliche Käufer.

Häufige Importfehler und was sie tatsächlich behebt

Das sind die Ausfälle, die am meisten Zeit in Anspruch nehmen. Jeder Fehler hat eine spezifische Ursache, die aus dem Fehlertext nicht immer ersichtlich ist.

“Die zulässige Speichergröße von X Bytes ist erschöpft”

PHP hatte während des Imports keinen Speicher mehr. Erheben speicher_limit in php.ini auf 2G, PHP-FPM neu starten, wiederholen. Wenn Sie php.ini nicht berühren können (Shared Hosting), Teilen Sie die CSV-Datei in Dateien auf 1,000-5,000 Zeilen einzeln und nacheinander importieren. Erweiterungen von Drittanbietern wie Firebear und Amasty fügen eine hinzu “Import ohne Speicherbegrenzung” umschalten, aber das ist eine Erweiterungsfunktion, kein natives Magento.

“Maximale Ausführungszeit von 30 Sekunden überschritten”

Ihr PHP max_execution_time ist zu niedrig. Anstoßen 1800 Sekunden. Auf Nginx, Sie müssen auch erhöhen fastcgi_read_timeout zusammenpassen, Andernfalls beendet Nginx den Upstream, bevor PHP fertig ist.

“Falsche Spaltenreihenfolge” oder “Der Header enthält ungültige Spalten”

Byte-Reihenfolge-Markierung. Ihre CSV-Datei wurde aus Excel gespeichert, Dadurch wird den UTF-8-Dateien eine Stückliste vorangestellt, die der Importer als verstümmelte erste Spalte liest. Erneuter Export aus Google Sheets oder erneutes Speichern über Notepad++ als UTF-8 ohne Stückliste. Wenn Sie nur eine Sache überprüfen, bevor Sie auf „Importieren“ klicken, Überprüfen Sie dies.

“Ungültiger Attributsatz” oder “Ungültiger Attributwert für X”

Ihre CSV verweist auf einen Attributsatz oder Dropdown-Wert, der in dieser Magento-Installation nicht vorhanden ist. Überprüfen Geschäfte > Attribute. Bei Dropdown-Werten wird die Groß-/Kleinschreibung und Leerzeichen beachtet. “Rot ” mit einem nachgestellten Leerzeichen ist dies nicht der Fall “Rot”.

Importieren “vervollständigt” aber Produkte erscheinen nicht im Frontend

Die Neuindizierung wurde nicht ausgeführt, oder der Cache ist veraltet. SSH rein und ausführen bin/magento-Indexer:neu indizieren gefolgt von bin/Magento-Cache:spülen. Auf 2.4.8 Bei Update by Schedule-Indexern ist dies seltener, passiert aber immer noch bei Produkt-URL- und Aktienindexern.

“Der URL-Schlüssel für den angegebenen Shop ist bereits vorhanden”

Sie importieren ein Produkt, dessen url_key kollidiert mit einem vorhandenen. Ändern Sie entweder den URL-Schlüssel in Ihrer CSV-Datei oder stellen Sie das Verhalten auf ein “Hinzufügen/Aktualisieren” eher als ein frisches “Komplexe Daten anhängen” laufen.

Hosting-Anforderungen für große Importe

Shared Hosting vernichtet mehr Magento-Importe als fehlerhafte CSVs. Wenn Sie eine Produktion betreiben 2.4.8 Geschäft, Der ehrliche Boden ist 4 GB RAM und 2-4 vCPUs; echte Kataloge (10k+ SKUs, häufige Reimporte) brauchen 8-16 GB. Die Festplatte sollte eine NVMe-SSD sein, keine rotierenden Laufwerke oder alten SATA-SSDs, weil Operationen zur Neuindizierung und Größenänderung von Bildern zu zufälligen E/A-Vorgängen führen.

Spezifische Dinge, die Ihnen ein Magento-fähiger Host ermöglichen sollte:

• Bearbeiten Sie php.ini (oder äquivalent pro Domäne) um das Speicherlimit und die Ausführungszeit zu erhöhen
• Cron installieren und ausführen (Der asynchrone Massenimport von Magento verwendet die Verbraucherwarteschlange)
• SSH-Zugriff für bin/magento CLI-Befehle
• Genügend Festplattenspielraum var/import/images kann Ihre größte Charge doppelt aufnehmen (Magento-Kopien, bewegt sich nicht)

Wenn Ihr aktueller Gastgeber diese nicht bereitstellen kann, Der Importeur ist nicht Ihr eigentliches Problem. Unser Zusammenfassung des Magento VPS-Hostings schlüsselt auf, welche Anbieter einen 2.4.8-ready-Stack ohne Aufpreis liefern, und der Hosting-Finder-Tool Filtert nach PHP-Version, RAM, und Bedienfeld, wenn Sie Pläne nebeneinander vergleichen möchten. Für Händler, die WooCommerce neben Magento betreiben (es passiert mehr als man denkt), das WordPress-E-Commerce-Hosting-Leitfaden deckt den Crossover-Stack ab.

Häufig gestellte Fragen

Was ist die maximale CSV-Dateigröße, die ich in Magento importieren kann? 2.4.8?

Der Admin-Importer begrenzt Uploads auf 2MB standardmäßig, gesteuert durch PHPs upload_max_filesize und post_max_size. Erhöhen Sie beide in php.ini für größere Dateien auf 64 MB. Für alles, was größer als 50 MB komprimiert ist, Wechseln Sie zum REST /V1/import/csv Endpunkt, Dies verarbeitet gzip-basierte Nutzlasten und verursacht keine Engpässe beim Browser-Upload.

Kann ich Produkte in Magento importieren? 2 ohne CSV zu verwenden?

Ja. Die REST-API von Magento 2.4.8 akzeptiert sowohl CSV als auch JSON über /V1/import/json. Erweiterungen von Drittanbietern (Feuerbär, Amasty, Magmi für ältere Installationen) unterstützt XML, Google Sheets-Synchronisierung, und direkte ERP-Anbindungen. Der native Administrator benötigt weiterhin CSV, Wählen Sie Ihren Weg also basierend auf den Automatisierungsanforderungen.

Wie lange dauert der Import von 10.000 Produkten??

Auf einem abgestimmten 2.4.8 Stapel (8 GB RAM, NVMe, PHP 8.4, MariaDB 11.4), erwarten 15-25 Protokoll für einen 10.000-Zeilen-Import mit Bildern. Shared Hosting treibt dies voran 60+ Minuten, wenn es überhaupt abgeschlossen ist. Der asynchrone REST-Massenpfad wird im Hintergrund ausgeführt, So bleiben die dem Käufer zugewandten Seiten während des Imports reaktionsfähig.

Warum ist mein Import erfolgreich, zeigt aber falsche Preise oder Lagerbestände an??

Zwei übliche Ursachen. Zuerst, Ihre CSV-Datei weist nachgestellte Leerzeichen oder eine europäische Komma-Dezimal-Formatierung auf (1,99 anstatt 1.99) in der Preisspalte; Magento analysiert diese als ungültig und behält den alten Wert bei. Zweite, Inventar aus mehreren Quellen (MSI) im 2.4.8 speichert Menge pro Quelle, nicht pro Produkt weltweit, also brauchst du das Quellcode Spalte oder der Import aktualisiert nur die Standardquelle.

Muss ich den Magento-Flat-Katalog vor dem Importieren deaktivieren??

Der flache Katalog wurde in veraltet 2.3 und aus Standard-Workflows entfernt von 2.4.5. Wenn Ihr Shop es irgendwie immer noch aktiviert hat, Deaktivieren Sie es unten Geschäfte > Aufbau > Katalog > Schaufenster vor großen Importen. Es handelte sich immer um eine Leistungspflicht und 2.4.8 Macht dies im Admin explizit.

Kann ich Produktimporte aus einem ERP oder PIM automatisieren??

Genau das ist es 2.4.8 REST-Endpunkte sind für. Tools wie Akeneo, Pimcore, und Salsify haben natives Magento 2 Anschlüsse. Für Sonderanfertigungen, cron ein Skript, das Ihren ERP-Feed abruft, wandelt sich in CSV um, gzips, und POSTs an /V1/import/csv. Planen Sie Zeiten außerhalb der Hauptverkehrszeiten ein, wenn der Import groß ist.

Schlussbemerkungen

Zwei Regeln entscheiden darüber, ob Ihr nächster Import funktioniert. Eins: Speichern Sie die CSV als UTF-8 ohne Stückliste. Immer. Zwei: PHP erhöhen speicher_limit und max_execution_time bevor du anfängst, nicht nach dem ersten Absturz. Alles andere sind Details.

Wegweise, Der Anruf ist einfach. Unter 5,000 SKUs und gelegentliche Importe? Verwenden Sie das Admin-CSV-Tool. Vergangenheit 10,000 SKUs oder nächtliche Synchronisierung aus einem ERP? Verwenden Sie den REST /V1/import/csv Endpunkt hinzugefügt 2.4.8 und hören Sie auf, den Prozess zu babysitten. Sichern Sie die Datenbank vor jedem Ersetzungs- oder Löschlauf. Schließen Sie niemals den Browser-Tab während des Imports. Und wenn der Stapel darunter nicht hält, Keine Importeur-Taktik kann es retten. Reparieren Sie zuerst den Host.

Für verwandte Lektüre: das Zusammenfassung des Magento-Themes deckt die Frontend-Leistung ab, nachdem Ihr Katalog geladen wurde, Das oben verlinkte Speed-Playbook kümmert sich um den Caching-Stack, und in den Hosting-Anleitungen erfahren Sie, worauf Sie alles ausführen müssen. Die langweiligen Infrastrukturentscheidungen summieren sich schneller als jedes einzelne Feature-Flag.