java.lang.IllegalArgumentException: Illegal base64 character 2d
Textul pe care îl decodezi nu e Base64 standard: conține un caracter nepermis (2d este codul hexazecimal pentru '-'). De obicei e Base64 URL-safe (cu - și _), ca la JWT. Folosește Base64.getUrlDecoder() sau elimină spațiile și rândurile noi.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Base64.getDecoder() acceptă doar alfabetul standard: A-Z, a-z, 0-9, +, / și = la final. La primul caracter străin aruncă Illegal base64 character 2d, unde numărul este codul hexazecimal al caracterului: 2d = -, 5f = _, 20 = spațiu, a = rând nou (\n), d = \r, 22 = ghilimele.
Situații tipice:
- token-uri JWT și parametri din URL, care folosesc varianta URL-safe (
-și_în loc de+și/, de obicei fără=); - text Base64 împărțit pe rânduri (e-mailuri, chei PEM) → folosește
getMimeDecoder(); - ghilimele sau spații rămase din JSON sau dintr-un copy-paste.
Alege decodorul după sursa textului: getDecoder(), getUrlDecoder() sau getMimeDecoder().
De ce apare: cauzele frecvente
1Token URL-safe (JWT)
val parte = token.split(".")[1]
val json = String(Base64.getDecoder().decode(parte))val parte = token.split(".")[1]
val json = String(Base64.getUrlDecoder().decode(parte))JWT folosește alfabetul URL-safe; getUrlDecoder acceptă - și _ și lipsa lui =.
2Rânduri noi în text
val date = Base64.getDecoder().decode(textDinEmail)val date = Base64.getMimeDecoder().decode(textDinEmail)Decodorul MIME ignoră rândurile noi și alte caractere din afara alfabetului.
3Ghilimele sau spații rămase
val b = Base64.getDecoder().decode("\"YWJj\" ")val b = Base64.getDecoder().decode("\"YWJj\" ".trim().trim('"'))Curăță textul înainte de decodare: spații, ghilimele, prefixe ca Basic .
Repară eroarea, direct în pagină
Programul decodează partea din mijloc a unui token, scrisă în Base64 URL-safe, cu decodorul standard, și se oprește cu Illegal base64 character 2d. Scoate cratima rămasă la final din token și folosește decodorul potrivit pentru URL-uri, ca programul să afișeze {"user":"ana"}.
import java.util.Base64
fun main() {
val token = "eyJ1c2VyIjoiYW5hIn0-"
val json = String(Base64.getDecoder().decode(token))
println(json)
}{"user":"ana"}Indiciu
Base64 pentru URL-uri se decodează cu Base64.getUrlDecoder(); cratima de la final nu face parte din date.
Reparația
import java.util.Base64
fun main() {
val token = "eyJ1c2VyIjoiYW5hIn0"
val json = String(Base64.getUrlDecoder().decode(token))
println(json)
}De ce merge
Decodorul standard acceptă doar A-Z a-z 0-9 + / și =, așa că s-a oprit la cratimă (cod hexazecimal 2d). Token-urile din URL-uri și JWT folosesc varianta URL-safe, fără = la final, pe care o citește getUrlDecoder(). Cratima de la final era un caracter rămas din copiere, iar fără ea textul se decodează în JSON-ul inițial.
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalArgumentException: Illegal base64 character 2djava.lang.IllegalArgumentException: Illegal base64 character 5fjava.lang.IllegalArgumentException: Illegal base64 character ajava.lang.IllegalArgumentException: Last unit does not have enough valid bitsjava.lang.IllegalArgumentException: Input byte array has wrong 4-byte ending unit
Cum o eviți pe viitor
Când codifici și decodezi în același sistem, folosește aceeași variantă la ambele capete (de exemplu getUrlEncoder().withoutPadding() și getUrlDecoder()). Pentru date care vin din exterior, curăță textul și alege decodorul după sursă. Nu pune Base64 standard în URL-uri fără codificare: + devine spațiu.
Întrebări frecvente
Cum aflu ce caracter este 2d?
Numărul e codul ASCII în hexazecimal: 2d = 45 = -. Alte valori frecvente: 5f = _, 20 = spațiu, a = rând nou, 3a = :.
Base64 e criptare?
Nu, e doar o codificare a octeților în text. Oricine poate decoda un token JWT; securitatea vine din semnătura lui, nu din Base64.
Erori înrudite
java.lang.IllegalArgumentException: URI is not absolute Ai transformat în URL o adresă relativă, fără schemă și host ("/api/produse"). toURL() cere o adresă completă, ca https://magazin.ro/api/produse. Construiește adresa pornind de la URL-ul de bază: URI(baza).resolve("/api/produse"). java.lang.NumberFormatException: For input string: "abc" Ai apelat toInt() (sau toDouble(), toLong()) pe un text care nu e un număr valid: "abc", "12.5" pentru Int, "" sau " 7" cu spații. Folosește toIntOrNull() și tratează null, sau curăță textul înainte (trim()). java.nio.charset.MalformedInputException: Input length = 1 Fișierul pe care îl citești nu e salvat în UTF-8 (de obicei e Windows-1250 / ISO-8859-2, din Excel sau dintr-un sistem vechi), iar Files.readAllLines / readString îl citesc ca UTF-8. Dă codificarea corectă la citire sau salvează fișierul în UTF-8. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
