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.
`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.FromBase64Stringnu acceptă această variantă. - prefixe:
"Basic dXNlcjpwYXJvbGE="din header-ulAuthorizationsau"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
string payload = "eyJ1c2VyIjoiYW5hIn0";
var bytes = Convert.FromBase64String(payload);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
string header = "Basic YW5hOmFkbWlu";
var bytes = Convert.FromBase64String(header);string header = "Basic YW5hOmFkbWlu";
var bytes = Convert.FromBase64String(header.Substring("Basic ".Length));Doar partea de după Basic este Base64.
3Text care nu e Base64
var bytes = Convert.FromBase64String("cod-promo-2024");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ă 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?"}.
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));{"user":"ana","rol":"admin?"}Indiciu
Token-urile JWT folosesc Base64URL: alte caractere și fără = la final.
Reparația
using System.Text;
string token = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiYW5hIiwicm9sIjoiYWRtaW4_In0.semnatura";
string payload = token.Split('.')[1].Replace('-', '+').Replace('_', '/');
payload = payload.PadRight(payload.Length + (4 - payload.Length % 4) % 4, '=');
byte[] bytes = Convert.FromBase64String(payload);
Console.WriteLine(Encoding.UTF8.GetString(bytes));De ce merge
Partea din mijloc a token-ului e în Base64URL: are _ în loc de / și nu are caracterele de completare =. Programul înlocuiește - și _ cu + și /, apoi adaugă = până când lungimea devine multiplu de 4. Textul devine Base64 standard, iar FromBase64String îl decodează.
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
Base64UrldinSystem.Buffers.Text(.NET 9) sauWebEncoders.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
System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui `JsonSerializer.Deserialize` nu este JSON valid. Caracterul dintre apostrofuri e primul lucru greșit: `'<'` înseamnă de obicei că ai primit o pagină HTML (o eroare a serverului), iar `'''` că valorile sunt între apostrofuri în loc de ghilimele. Verifică textul înainte și tratează `JsonException`. System.FormatException: Unrecognized Guid format. `Guid.Parse` a primit un text care nu e un GUID valid: e gol, e tăiat, are caractere în afară de `0-9`, `a-f` și cratime sau are alt număr de cifre decât 32. Verifică valoarea și folosește `Guid.TryParse` pentru texte venite din afară (URL, formular, fișier). Î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.
