...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

System.FormatException: The input is not a valid Base-64 string as it contains a non-base 64 character, more than two padding characters, or an illegal character among the padding characters.

Pe scurt

`Convert.FromBase64String` a primit un text care nu e Base64 standard: are caractere ca `-`, `_`, spații sau prefixe (`Basic `, `data:image/png;base64,`), ori îi lipsește completarea `=` (lungimea nu e multiplu de 4). Curăță textul, înlocuiește `-`/`_` cu `+`/`/` și adaugă `=` până la multiplu de 4.

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

Ce înseamnă

Base64 standard folosește doar literele A-Z, a-z, cifrele, +, / și caracterul de completare = la final, iar lungimea textului e multiplu de 4. Orice abatere face ca Convert.FromBase64String să arunce această FormatException.

Cauzele întâlnite în practică:

  • Base64URL: token-urile JWT, link-urile și unele API-uri folosesc - și _ în loc de + și / și scot = de la final. FromBase64String nu acceptă această variantă.
  • prefixe: "Basic dXNlcjpwYXJvbGE=" din header-ul Authorization sau "data:image/png;base64,iVBOR...". Doar partea de după prefix e Base64.
  • textul nu e Base64 deloc (un id, un hash hexazecimal, un text simplu), sau a fost tăiat la copiere.

Spațiile și liniile noi sunt ignorate, deci un text împărțit pe mai multe rânduri nu e o problemă.

De ce apare: cauzele frecvente

1Base64URL dintr-un token

Greșit
C#
string payload = "eyJ1c2VyIjoiYW5hIn0";
var bytes = Convert.FromBase64String(payload);
Corect
C#
string payload = "eyJ1c2VyIjoiYW5hIn0";
string b64 = payload.Replace('-', '+').Replace('_', '/');
b64 = b64.PadRight(b64.Length + (4 - b64.Length % 4) % 4, '=');
var bytes = Convert.FromBase64String(b64);

Înlocuiești caracterele URL cu cele standard și completezi cu = până la multiplu de 4.

2Prefixul a rămas în text

Greșit
C#
string header = "Basic YW5hOmFkbWlu";
var bytes = Convert.FromBase64String(header);
Corect
C#
string header = "Basic YW5hOmFkbWlu";
var bytes = Convert.FromBase64String(header.Substring("Basic ".Length));

Doar partea de după Basic este Base64.

3Text care nu e Base64

Greșit
C#
var bytes = Convert.FromBase64String("cod-promo-2024");
Corect
C#
var buffer = new byte[64];
if (Convert.TryFromBase64String("cod-promo-2024", buffer, out int n))
    Console.WriteLine(n);
else
    Console.WriteLine("nu e Base64");

TryFromBase64String verifică fără excepție dacă textul e Base64 valid.

Repară tu

Repară eroarea, direct în pagină

Programul decodează partea din mijloc a unui token JWT ca să afișeze datele utilizatorului, dar se oprește cu System.FormatException: The input is not a valid Base-64 string.... Repară decodarea ca programul să afișeze {"user":"ana","rol":"admin?"}.

Codul care dă eroarea
C#
using System.Text;

string token = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiYW5hIiwicm9sIjoiYWRtaW4_In0.semnatura";
string payload = token.Split('.')[1];
byte[] bytes = Convert.FromBase64String(payload);
Console.WriteLine(Encoding.UTF8.GetString(bytes));
După reparație, programul afișează
{"user":"ana","rol":"admin?"}
Indiciu

Token-urile JWT folosesc Base64URL: alte caractere și fără = la final.

Alte forme ale mesajului

  • System.FormatException: The input is not a valid Base-64 string as it contains a non-base 64 character, more than two padding characters, or a non-white space-character among the padding characters.
  • System.FormatException: Invalid length for a Base-64 char array or string.

Cum o eviți pe viitor

  • Pentru Base64URL folosește Base64Url din System.Buffers.Text (.NET 9) sau WebEncoders.Base64UrlDecode în ASP.NET Core.
  • Când primești Base64 din exterior, separă întâi prefixele (Basic , data:...;base64,).
  • Validează cu Convert.TryFromBase64String înainte de decodare, dacă textul vine de la utilizator.

Întrebări frecvente

Cum recunosc Base64URL?

Are - sau _ în text și de obicei nu are = la final. Token-urile JWT (trei bucăți separate de puncte) sunt mereu Base64URL.

De ce textul meu e acceptat de un site de decodare, dar nu de .NET?

Multe site-uri acceptă automat și Base64URL și completează singure =. Convert.FromBase64String acceptă doar forma standard.

Erori înrudite

← Toate erorile C#

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ță C# de la zero, cu exerciții la fiecare lecție

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