java.lang.IllegalArgumentException: Illegal base64 character 2d
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=-și5f=_: 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ștegetMimeDecoder()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
String token = "dXNlcj9pZD4-";
byte[] b = Base64.getDecoder().decode(token);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
String cheie = "TUlJQk...\nQUFC...";
byte[] b = Base64.getDecoder().decode(cheie);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
String valoare = "\"U2FsdXQ=\" ";
Base64.getDecoder().decode(valoare);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ă 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>>.
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));
}
}Continut token: user?id>>
Indiciu
Tokenul folosește alfabetul URL-safe (cu -), deci ai nevoie de Base64.getUrlDecoder().
Reparația
import java.nio.charset.StandardCharsets;
import java.util.Base64;
public class Main {
public static void main(String[] args) {
String token = "dXNlcj9pZD4-";
byte[] octeti = Base64.getUrlDecoder().decode(token);
System.out.println("Continut token: " + new String(octeti, StandardCharsets.UTF_8));
}
}De ce merge
Codul hexazecimal 2d este caracterul -, care nu există în alfabetul Base64 standard, ci doar în varianta URL-safe, folosită pentru tokenuri în adrese. Base64.getUrlDecoder() citește - ca pe valoarea pe care o are + în varianta standard, așa că decodarea reușește și obținem textul original.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Illegal base64 character 5fjava.lang.IllegalArgumentException: Illegal base64 character 20java.lang.IllegalArgumentException: Illegal base64 character ajava.lang.IllegalArgumentException: Input byte array has wrong 4-byte ending unitjava.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
java.net.URISyntaxException: Illegal character in query at index 27: https://site.ro/cauta?q=ana maria Adresa dată lui new URI(...) sau URI.create conține caractere nepermise neencodate, de obicei spații, diacritice sau |, în query ori în cale. Encodează valorile cu URLEncoder.encode(valoare, StandardCharsets.UTF_8) înainte să le pui în URL. java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. error: illegal character: '\u201c' În cod ai ghilimele „inteligente” (“ ” sau „ ”) în loc de ghilimele drepte ". Se întâmplă când copiezi cod din Word, dintr-un PDF sau de pe un site. Înlocuiește-le cu " și eroarea dispare. Î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.
