...
Eroare Kotlin · Biblioteca standard, Java și formatare

java.lang.IllegalArgumentException: Illegal base64 character 2d

Pe scurt

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)

Greșit
KOTLIN
val parte = token.split(".")[1]
val json = String(Base64.getDecoder().decode(parte))
Corect
KOTLIN
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

Greșit
KOTLIN
val date = Base64.getDecoder().decode(textDinEmail)
Corect
KOTLIN
val date = Base64.getMimeDecoder().decode(textDinEmail)

Decodorul MIME ignoră rândurile noi și alte caractere din afara alfabetului.

3Ghilimele sau spații rămase

Greșit
KOTLIN
val b = Base64.getDecoder().decode("\"YWJj\" ")
Corect
KOTLIN
val b = Base64.getDecoder().decode("\"YWJj\" ".trim().trim('"'))

Curăță textul înainte de decodare: spații, ghilimele, prefixe ca Basic .

Repară tu

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"}.

Codul care dă eroarea
KOTLIN
import java.util.Base64

fun main() {
    val token = "eyJ1c2VyIjoiYW5hIn0-"
    val json = String(Base64.getDecoder().decode(token))
    println(json)
}
După reparație, programul afișează
{"user":"ana"}
Indiciu

Base64 pentru URL-uri se decodează cu Base64.getUrlDecoder(); cratima de la final nu face parte din date.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalArgumentException: Illegal base64 character 2d
  • java.lang.IllegalArgumentException: Illegal base64 character 5f
  • java.lang.IllegalArgumentException: Illegal base64 character a
  • java.lang.IllegalArgumentException: Last unit does not have enough valid bits
  • java.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

← Toate erorile Kotlin

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ță 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.