Base64-Bereinigung

Originaleingang
0 Zeichen

Kostenloses Online-Base64-Bereinigungstool, das Zeilenumbrüche, Leerzeichen, unsichtbare Zeichen und andere ungültige Inhalte aus Base64-Strings entfernt. Drei unabhängige Optionen (Whitespace entfernen, Sonderzeichen entfernen, Padding automatisch ergänzen); Ausgabe streng nach RFC 4648.

Ähnliche Tools

Was ist Base64-Bereinigung?

Base64-Bereinigung ist das Entfernen aller ungültigen und überflüssigen Zeichen aus einem Base64-String. Ziel ist die Ausgabe reinen Base64, das streng RFC 4648 entspricht, damit es zwischen Systemen übertragen, gespeichert und dekodiert werden kann.

Warum bereinigen: Base64 aus verschiedenen Quellen enthält häufig unerwünschte Zeichen. ① Zeilenumbrüche (\n, \r\n) – aus E-Mail-Anhängen, Datenbankfeldern oder Log-Ausgaben; ② Leerzeichen und Tabulatoren – beim manuellen Einfügen oder Kopieren aus Excel; ③ UTF-8-BOM (EF BB BF) – von unter Windows gespeicherten Textdateien; ④ Vollbreitzeichen und chinesische Satzzeichen – Kopierfehler. Alle diese führen zu Decoder-Fehlern.

Drei Bereinigungsoptionen: ① Whitespace entfernen (Leerzeichen, \n, \r, \t) – behandelt Zeilenumbrüche und Leerzeichen; ② Sonderzeichen entfernen – behält nur das Base64-Alphabet A-Z a-z 0-9 + / = - _ bei; ③ Padding automatisch ergänzen – macht die Ergebnislänge zu einem Vielfachen von 4. Die drei Optionen sind unabhängig voneinander auswählbar und können beliebig kombiniert werden.

Typische Anwendungsfälle: ① API-Debugging – Bereinigen von Base64 aus Drittschnittstellen, die beim Einfügen Fehler verursachen; ② Datenbankimport – Entfernen überflüssiger Leerzeichen beim Kopieren aus Excel; ③ Vorverarbeitung vor dem Dekodieren – Vermeiden von InvalidCharacterError bei atob(); ④ JWT-/Data-URL-Normalisierung – Beheben von Unterschieden bei der systemübergreifenden Übertragung.

Anwendungsfälle

  • Vorverarbeitung vor dem Dekodieren: Bereinigt Base64 mit Zeilenumbrüchen oder Leerzeichen aus Drittschnittstellen, JWTs oder Logs in eine direkt dekodierbare Form, um InvalidCharacterError zu vermeiden.
  • Reparatur beim Einfügen aus Excel/E-Mails: Entfernt überflüssige Leerzeichen, Tabulatoren und Zeilenumbrüche, die beim Kopieren aus Excel-Zellen oder E-Mail-Textkörpern mitgerissen werden.
  • JWT-Token-Bereinigung: Normalisiert dreiteilige JWT-Strings (header.payload.signature) mit Zeilenumbrüchen zu einer einzigen Zeile und entfernt überflüssigen Whitespace.
  • MIME-Anhang-Verarbeitung: Bereinigt das alle 76 Zeichen umgebrochene Format von E-Mail-Anhang-Base64 für eine anschließende Dekodierung.
  • URL-Safe-Kompatibilität: Behält - und _ bei, damit Base64 in JWTs, URL-Pfaden und Dateinamen nicht versehentlich zerstört wird.
  • Vorverarbeitung vor der Massenbereinigung: In Kombination mit base64-format / base64-padding verwenden – zuerst bereinigen, dann formatieren oder Padding ergänzen.

Anleitung

  1. Fügen Sie den verrauschten Base64-String ein oder geben Sie ihn ein (Zeilenumbrüche, Leerzeichen und andere ungültige Zeichen sind erlaubt).
  2. Wählen Sie die gewünschten Bereinigungsoptionen: Whitespace entfernen, Sonderzeichen entfernen, Padding automatisch ergänzen (standardmäßig sind alle drei aktiviert).
  3. Betrachten Sie die Ausgabe auf der rechten Seite: Sie zeigt in Echtzeit das bereinigte Base64, die Zeichenzählung, die Anzahl entfernter Zeichen und die Dekodiergültigkeit an.
  4. Kopieren Sie das Ergebnis in die Zwischenablage oder laden Sie es als .txt-Datei zur weiteren Verarbeitung herunter.

Funktionen

  • Whitespace-entfernen-Option: Entfernt automatisch \n, \r, \t und Leerzeichen, geeignet für E-Mail-Anhänge, Excel-Einfügungen und ähnliche Szenarien.
  • Sonderzeichen-entfernen-Option: Behält nur die 66 gültigen Base64-Zeichen bei: A-Z a-z 0-9 + / = - _.
  • Padding automatisch ergänzen: Aktivierbar, um die Ergebnislänge auf ein Vielfaches von 4 zu bringen und Längenfehler zu beheben.
  • Drei unabhängige, kombinierbare Optionen: Nach Bedarf auswählbar, flexibel für unterschiedliche Verschmutzungsgrade.
  • URL-Safe-Zeichen bleiben erhalten: - und _ werden nicht versehentlich gelöscht, um Zeichenverlust in JWT-/URL-Szenarien zu vermeiden.
  • Echtzeit-Validierung der Ausgabe: Prüft per atob() im Browser, ob die Ausgabe dekodierbar ist; Status wird in Echtzeit angezeigt.
  • Zeichenzählung und Entfernungsanzeige: Zeigt live Eingabe-/Ausgabezeichenzahl, Anzahl entfernter Zeichen und Dekodierstatus an.
  • Lokale Verarbeitung im Browser: Alle Bereinigungsvorgänge laufen lokal ab; das ursprüngliche Base64 wird an keinen Server übermittelt.

Best Practices

Erst bereinigen, dann mit dem Padding-Tool ergänzen

Die Bereinigung entfernt nur ungültige Zeichen und ergänzt optional Padding. Wenn das Base64 gleichzeitig Zeilenumbrüche und fehlendes Padding aufweist, aktivieren Sie zunächst alle drei Bereinigungsoptionen und prüfen Sie, ob die Ausgabelänge noch kein Vielfaches von 4 ist. Besteht weiterhin eine Padding-Anomalie, verwenden Sie anschließend das dedizierte Padding-Tool.

Dreiteiligen JWT-Token separat behandeln

JWT ist ein dreiteiliger Base64URL-String (header.payload.signature), verbunden durch Punkte. Bei der Bereinigung müssen alle drei Teile von Whitespace befreit werden, aber zwischen den Teilen dürfen keine zusätzlichen Zeichen eingefügt werden, da sonst die Signaturprüfung fehlschlägt. Es empfiehlt sich, vor dem Einfügen nach Punkten zu teilen, die Teile einzeln zu bereinigen und sie dann wieder zusammenzufügen.

Bei URL-Safe-Eingabe „Sonderzeichen entfernen“ ggf. deaktivieren

URL-Safe-Base64 verwendet - und _ anstelle von + und /. Dieses Tool behält standardmäßig alle vier Zeichen bei. Haben Sie jedoch manuell eine strengere Whitelist festgelegt (nur +/ erlaubt), wird URL-Safe-Eingabe zerstört. Wenn Sie den Zeichensatz nicht sicher kennen, deaktivieren Sie „Sonderzeichen entfernen“ und belassen Sie nur „Whitespace entfernen“.

Treten nach der Bereinigung weiterhin Fehler auf? Kodierung und BOM prüfen

Wenn atob() nach der Bereinigung weiterhin InvalidCharacterError meldet, könnten Reste eines UTF-8-BOM (EF BB BF) oder UTF-16-Byte-Order-Marks vorhanden sein. Die Option „Whitespace entfernen“ zielt nicht auf BOM ab. Es empfiehlt sich, im Browser-Konsolenfenster per TextDecoder erneut als UTF-8 zu dekodieren und dann nochmals zu bereinigen.

BOM-Quelle erkennen: Unter Windows gespeicherte TXT-Dateien

Stammt das Base64 aus einer mit Windows-Notepad als UTF-8 gespeicherten Datei, sind die ersten 3 Bytes (EF BB BF) das BOM. Selbst nach dem Entfernen von Whitespace und Zeilenumbrüchen kann atob() fehlschlagen. Abhilfe: Mit VS Code oder PowerShell erneut als UTF-8 ohne BOM speichern.

Vorher-Nachher-Vergleiche bei Lehr- und Dokumentationsdemonstrationen zeigen

Base64-Bereinigung ist ein häufiges Problem im Unterricht. Es empfiehlt sich, in der Dokumentation sowohl das Base64 vor als auch nach der Bereinigung anzugeben, ergänzt durch Vergleiche der Zeichenanzahl und des Dekodierstatus, damit Leser die Wirkung jeder Option intuitiv verstehen.

Häufig gestellte Fragen

Verändert die Base64-Bereinigung die ursprünglichen Bytes?

Nein. Die Bereinigung entfernt nur ungültige Zeichen (Whitespace, Zeilenumbrüche, nicht-Base64-Zeichen), ohne die dazwischenliegenden gültigen Zeichen zu verändern. Wenn nur Whitespace und ungültige Zeichen entfernt werden, sind die Bytes vor und nach der Bereinigung identisch. Wenn „Padding automatisch ergänzen“ aktiviert ist, werden lediglich = am Ende angefügt, was die ursprünglichen Bytes nicht beeinflusst.

Worin unterscheiden sich die drei Bereinigungsoptionen?

Whitespace entfernen: Entfernt Leerzeichen, \n, \r und \t. Sonderzeichen entfernen: Behält nur die 66 Base64-Gültigkeitszeichen A-Z a-z 0-9 + / = - _ bei. Padding automatisch ergänzen: Fügt am Ende = an, damit die Länge ein Vielfaches von 4 wird. Die drei Optionen sind unabhängig und kombinierbar.

Warum meldet atob() InvalidCharacterError?

Häufige Ursachen: ① Enthält chinesische Zeichen, Unicode-Emojis oder andere Nicht-ASCII-Zeichen; ② Enthält Zeilenumbrüche oder Leerzeichen (häufig beim Kopieren aus Excel oder E-Mails); ③ Base64URL-Zeichen (- _) sind falsch verwendet; ④ Die Länge ist kein Vielfaches von 4. Die Bereinigung dieses Tools behebt die ersten drei Probleme, das Padding-Tool das vierte.

Wird bei der Bereinigung das Padding entfernt?

Nein. = ist ein gültiges Base64-Zeichen und wird von der Option „Sonderzeichen entfernen“ explizit beibehalten. Wenn Sie Padding entfernen möchten, verwenden Sie das dedizierte Padding-Tool (base64-padding) im Modus „Padding entfernen“.

Wie werden enthaltene Zeilenumbrüche bereinigt?

Standardmäßig ist „Whitespace entfernen“ aktiviert, was dies erledigt. Zeilenumbrüche (\n / \r\n), Tabulatoren und Leerzeichen werden entfernt. Wenn Sie Zeilenumbrüche beibehalten möchten (MIME-E-Mail-Anhang-Format), deaktivieren Sie die Option „Whitespace entfernen“.

Kann dieses Tool UTF-8 BOM verarbeiten?

Das BOM (EF BB BF) ist das Unicode-Zeichen U+FEFF. Die Option „Whitespace entfernen“ dieses Tools verwendet den regulären Ausdruck \s \n \r \t, der U+FEFF nicht einschließt, sodass das BOM möglicherweise verbleibt. Tritt ein durch BOM verursachter InvalidCharacterError auf, empfehlen wir, das BOM zunächst im Code oder in der Browser-Konsole per TextDecoder zu entfernen.

Werden URL-Safe- und Standard-Base64-Zeichen ineinander konvertiert?

Nein. Die Option „Sonderzeichen entfernen“ behält + / - _ alle vier bei und führt lediglich eine Rauschentfernung durch, ohne aktive Konvertierung. Für eine Konvertierung zwischen URL-Safe und Standard verwenden Sie das dedizierte Base64URL-Tool (base64-url-safe).

Werden meine Inhalte an einen Server hochgeladen?

Nein. Alle Bereinigungslogik wird lokal im Browser ausgeführt; der ursprüngliche Base64-String verlässt Ihr Gerät nicht. Auch sensible Daten wie Anmeldedaten, Schlüssel oder Tokens können bedenkenlos verarbeitet werden.

Können mehrere Base64-Abschnitte auf einmal bereinigt werden?

Dieses Tool bietet eine Einzelabschnitt-Bereinigungsoberfläche. Wenn mehrere Base64-Abschnitte zu bereinigen sind, empfehlen wir, die Logik dieses Tools wiederholt aufzurufen oder ein entsprechendes Kommandozeilenwerkzeug (z. B. den base64-Befehl) zu verwenden. Für Massen-Kodierung/Dekodierung nutzen Sie bitte base64-batch-encode / base64-batch-decode.

Fehlerbehebung

Nach der Bereinigung meldet atob() weiterhin Fehler

Mögliche Ursache ist ein Längenproblem (kein Vielfaches von 4) oder BOM-/Kodierungsreste. Stellen Sie sicher, dass „Padding automatisch ergänzen“ aktiviert ist. Falls der Fehler fortbesteht, dekodieren Sie im Browser-Konsolenfenster mit TextDecoder erneut als UTF-8, entfernen Sie das BOM und bereinigen Sie erneut.

Länge hat sich nach der Bereinigung geändert, aber das Dekodieren schlägt weiterhin fehl

Möglicherweise ist der Originalinhalt kein Standard-Base64, sondern Base32 / Base58 / Base85. Prüfen Sie das Kodierungsformat der Originaldaten und wechseln Sie zum entsprechenden Tool. Sie können auch versuchen, den Originalstring vor atob() mit btoa() zu testen, ob er sich neu kodieren lässt.

Nach der Bereinigung sind nur sehr wenige Zeichen übrig

Wahrscheinlich ist die Option „Sonderzeichen entfernen“ zu streng eingestellt und hat + / - _ ebenfalls entfernt. Prüfen Sie, ob Sie die Zeichen-Whitelist versehentlich deaktiviert haben; dieses Tool behält standardmäßig alle 66 gültigen Base64-Zeichen bei. Wenn die Eingabe URL-Safe ist, deaktivieren Sie „Sonderzeichen entfernen“.

Nach dem Einfügen erscheint keine Ausgabe

Möglicherweise besteht die Eingabe ausschließlich aus Whitespace-Zeichen (nur Leerzeichen / Zeilenumbrüche / Tabulatoren). Die Option „Whitespace entfernen“ entfernt diese vollständig und hinterlässt einen leeren String. Prüfen Sie, ob die ursprüngliche Eingabe mindestens ein Base64-Zeichen enthält (A-Z a-z 0-9 + / =).

Glossar

UTF-8 BOM
Byte Order Mark. Ein 3-Byte-Präfix (0xEF 0xBB 0xBF), das Windows beim Speichern von UTF-8-Text anhängt. Es führt dazu, dass der Base64-Decoder das erste Zeichen als ungültiges Byte behandelt.
URL Safe Base64
Die in RFC 4648 §5 definierte URL-sichere Base64-Variante, bei der + und / durch - und _ ersetzt werden. Die Option „Sonderzeichen entfernen“ dieses Tools behält diese 4 Zeichen bei, um ein versehentliches Löschen zu vermeiden.
Zeilenumbruch
\r\n (Windows) und \n (Unix/macOS). MIME-Base64 aus E-Mail-Anhängen bricht meist alle 76 Zeichen um; diese Umbrüche müssen bei der Bereinigung entfernt werden.
Gültige Base64-Zeichen
Der Standard-Base64-Zeichensatz umfasst A-Z, a-z, 0-9, +, /, = (Padding) plus die URL-Safe-Varianten - und _ – insgesamt 66 gültige Zeichen.
InvalidCharacterError
Der Dekodierungsfehler, der von der Browser-Funktion atob() ausgelöst wird. Er tritt auf, wenn der Base64-String Zeichen außerhalb der gültigen Zeichentabelle enthält (chinesische Zeichen, Whitespace, Sonderzeichen usw.).

Base64-Zeichensatz und Beibehaltungsregeln

Die von der Option „Sonderzeichen entfernen“ beibehaltenen gültigen Zeichen.

ZeichentypZeichenBeibehaltungsregel
BuchstabenA-Z, a-z52 Zeichen, werden beibehalten
Ziffern0-910 Zeichen, werden beibehalten
Standard-Base64-Symbole+ /2 Zeichen, werden beibehalten
URL-Safe-Symbole- _2 Zeichen, in URL-Safe-Szenarien beibehalten
Padding=Auffüllzeichen am Ende, wird beibehalten
WhitespaceLeerzeichen, \n, \r, \tBei Option „Whitespace entfernen“ entfernt
SonstigeChinesische Zeichen / Emojis / BOM usw.Bei Option „Sonderzeichen entfernen“ entfernt

5 häufige Quellen für Base64-Verunreinigungen

So gelangen ungültige Inhalte in Base64-Strings.

VerunreinigungsquelleEingeschleuste InhalteEmpfohlene Option
E-Mail-Anhang\r\n alle 76 ZeichenWhitespace entfernen
Excel-/Datenbank-EinfügungFührende/nachfolgende Leerzeichen / TabWhitespace entfernen
Windows-TXT-DateiUTF-8 BOM (EF BB BF)Sonderzeichen entfernen + BOM manuell beseitigen
URL / Dateiname+ / ZeichenkonfliktURL-Safe beibehalten (mit base64-url-safe konvertieren)
Log-/Trace-AusgabeDebug-Präfix / -SuffixSonderzeichen entfernen

Vergleich der 3 Bereinigungsoptionen

Die drei Optionen sind unabhängig und kombinierbar.

OptionVerhaltenTypisches Szenario
Whitespace entfernenEntfernt Leerzeichen, \n, \r, \tE-Mails / Excel / Logs
Sonderzeichen entfernenBehält nur das Base64-Alphabet beiEingemischte Chinesische Zeichen / Emojis / BOM
Padding automatisch ergänzenFügt = am Ende an bis zu einem Vielfachen von 4Länge kein Vielfaches von 4

Authoritative References