...
Eroare Java · Reflecție, module și alte API-uri

java.lang.IllegalArgumentException: Illegal base64 character 2d

Pe scurt

Base64.getDecoder() a întâlnit un caracter care nu face parte din alfabetul Base64 standard; 2d e codul hexazecimal pentru -, iar 5f pentru _, adică text encodat în varianta URL-safe (ca în tokenurile JWT). Folosește Base64.getUrlDecoder() sau, pentru spații și rânduri noi, getMimeDecoder().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Base64 are mai multe alfabete. Cel standard (Base64.getDecoder()) folosește A–Z, a–z, 0–9, + și /. Varianta URL-safe (getUrlDecoder()), folosită în URL-uri și în tokenurile JWT, înlocuiește + cu - și / cu _. Când decodorul standard întâlnește un caracter care nu e în alfabetul lui, aruncă Illegal base64 character urmat de codul caracterului în hexazecimal:

  • 2d = - și 5f = _: textul e URL-safe;
  • 20 = spațiu, a = rând nou (\n), d = \r: textul are spații sau e împărțit pe rânduri (folosește getMimeDecoder() sau curăță-l);
  • 22 = ghilimele: ai decodat cu tot cu ghilimelele din JSON.

O eroare înrudită, Input byte array has wrong 4-byte ending unit sau Last unit does not have enough valid bits, înseamnă că textul e trunchiat sau lipsesc caracterele = de la final.

De ce apare: cauzele frecvente

1Token URL-safe decodat cu decodorul standard

Greșit
JAVA
String token = "dXNlcj9pZD4-";
byte[] b = Base64.getDecoder().decode(token);
Corect
JAVA
String token = "dXNlcj9pZD4-";
byte[] b = Base64.getUrlDecoder().decode(token);

Decodorul URL-safe înțelege - și _, folosite în locul lui + și /.

2Text Base64 pe mai multe rânduri

Greșit
JAVA
String cheie = "TUlJQk...\nQUFC...";
byte[] b = Base64.getDecoder().decode(cheie);
Corect
JAVA
String cheie = "TUlJQk...\nQUFC...";
byte[] b = Base64.getMimeDecoder().decode(cheie);

Decodorul MIME ignoră rândurile noi și alte caractere din afara alfabetului, ca în fișierele PEM sau emailuri.

3Ghilimele sau spații în plus

Greșit
JAVA
String valoare = "\"U2FsdXQ=\" ";
Base64.getDecoder().decode(valoare);
Corect
JAVA
String valoare = "\"U2FsdXQ=\" ";
Base64.getDecoder().decode(valoare.trim().replace("\"", ""));

Textul trebuie să conțină doar caracterele Base64. Scoți ghilimelele luate din JSON și spațiile.

Repară tu

Repară eroarea, direct în pagină

Programul decodează partea de date a unui token primit într-un URL, dar se oprește cu IllegalArgumentException: Illegal base64 character 2d. Folosește decodorul potrivit, ca programul să afișeze Continut token: user?id>>.

Codul care dă eroarea
JAVA
import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Main {
    public static void main(String[] args) {
        String token = "dXNlcj9pZD4-";
        byte[] octeti = Base64.getDecoder().decode(token);
        System.out.println("Continut token: " + new String(octeti, StandardCharsets.UTF_8));
    }
}
După reparație, programul afișează
Continut token: user?id>>
Indiciu

Tokenul folosește alfabetul URL-safe (cu -), deci ai nevoie de Base64.getUrlDecoder().

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Illegal base64 character 5f
  • java.lang.IllegalArgumentException: Illegal base64 character 20
  • java.lang.IllegalArgumentException: Illegal base64 character a
  • java.lang.IllegalArgumentException: Input byte array has wrong 4-byte ending unit
  • java.lang.IllegalArgumentException: Last unit does not have enough valid bits

Cum o eviți pe viitor

  • Folosește la decodare aceeași variantă ca la encodare: getEncoder/getDecoder, getUrlEncoder/getUrlDecoder.
  • Pentru tokenuri JWT, folosește o bibliotecă dedicată (de exemplu jjwt sau Nimbus), nu decodare manuală.
  • Curăță textul (trim, fără ghilimele) înainte de decodare.
  • Când primești Base64 din alt sistem, întreabă sau verifică ce variantă folosește.

Întrebări frecvente

Cum aflu ce caracter e 2d?

E codul hexazecimal ASCII: 2d = -, 5f = _, 20 = spațiu, 22 = ghilimele, a = rând nou. Orice tabel ASCII îți arată corespondența.

Base64 înseamnă criptare?

Nu. Base64 e doar o codificare a octeților în text, pe care oricine o poate decoda. Nu protejează date secrete.

Erori înrudite

← Toate erorile Java

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.