java.nio.charset.UnsupportedCharsetException: UFT-8
Numele codificării dat la Charset.forName (sau la new String, getBytes, InputStreamReader) nu e recunoscut, de obicei din cauza unei greșeli de scriere: UFT-8, UTF_8, "utf 8". Folosește constantele StandardCharsets.UTF_8, care nu pot fi scrise greșit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Java cunoaște codificările după nume și aliasuri: UTF-8 (și utf8), ISO-8859-1 (latin1), windows-1252, US-ASCII. Când primește un nume care nu există, reacția depinde de API:
Charset.forName("UFT-8")aruncăUnsupportedCharsetException: UFT-8;- un nume cu caractere nepermise, de exemplu cu spațiu (
"UTF 8"), dăIllegalCharsetNameException: UTF 8; new String(octeti, "UTF_8")șitext.getBytes("UTF_8")aruncăUnsupportedEncodingException: UTF_8, o excepție verificată.
Atenție la UTF_8: este numele constantei din Java (StandardCharsets.UTF_8), dar nu și numele codificării, care se scrie cu cratimă. Numele vin des din configurare, unde nu le verifică nimeni la compilare.
De ce apare: cauzele frecvente
1Nume scris greșit
Charset cs = Charset.forName("UFT-8");Charset cs = StandardCharsets.UTF_8;Constanta e verificată de compilator și nu aruncă niciodată excepție.
2Numele constantei folosit ca text
String s = new String(octeti, "UTF_8");String s = new String(octeti, StandardCharsets.UTF_8);Varianta cu Charset nu mai aruncă UnsupportedEncodingException, deci nu ai nici excepție verificată de tratat.
3Nume din configurare cu spații
Charset cs = Charset.forName(config.get("encoding")); // " UTF-8"Charset cs = Charset.forName(config.get("encoding").strip());Un spațiu face numele invalid (IllegalCharsetNameException). strip() curăță valoarea.
Repară eroarea, direct în pagină
Programul transformă un mesaj în octeți folosind codificarea din configurare, dar numele e scris greșit și programul se oprește cu UnsupportedCharsetException: UFT-8. Folosește StandardCharsets.UTF_8, ca programul să afișeze Octeti: 6 și Text: Salut!.
import java.nio.charset.Charset;
public class Main {
public static void main(String[] args) {
Charset codificare = Charset.forName("UFT-8");
byte[] octeti = "Salut!".getBytes(codificare);
System.out.println("Octeti: " + octeti.length);
System.out.println("Text: " + new String(octeti, codificare));
}
}Octeti: 6 Text: Salut!
Indiciu
Înlocuiește Charset.forName("UFT-8") cu StandardCharsets.UTF_8.
Reparația
import java.nio.charset.Charset;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) {
Charset codificare = StandardCharsets.UTF_8;
byte[] octeti = "Salut!".getBytes(codificare);
System.out.println("Octeti: " + octeti.length);
System.out.println("Text: " + new String(octeti, codificare));
}
}De ce merge
Charset.forName caută codificarea după nume, iar UFT-8 nu există, deci aruncă excepția la rulare. StandardCharsets.UTF_8 este o constantă: dacă o scrii greșit, codul nu compilează, iar valoarea ei e mereu disponibilă. Textul Salut! are doar litere simple, deci în UTF-8 ocupă 6 octeți, iar decodarea cu aceeași codificare îl redă identic.
Alte forme ale mesajului
java.io.UnsupportedEncodingException: UTF_8java.nio.charset.IllegalCharsetNameException: UTF 8java.nio.charset.UnsupportedCharsetException: UTF-9
Cum o eviți pe viitor
- Folosește
StandardCharsets.UTF_8,ISO_8859_1,US_ASCII,UTF_16în loc de nume scrise ca text. - Pentru alte codificări (
windows-1252,windows-1250), ține numele într-o singură constantă. - Validează la pornire codificările citite din configurare cu
Charset.isSupported(nume). - Preferă metodele care primesc
Charset, nuString: nu aruncăUnsupportedEncodingException.
Întrebări frecvente
Care e lista codificărilor suportate?
Charset.availableCharsets() întoarce toate codificările pe care le cunoaște JVM-ul curent, cu numele lor canonice. Aliasurile unei codificări le afli cu charset.aliases().
Scriu utf-8 cu litere mici. E o problemă?
Nu. Numele nu țin cont de litere mari sau mici, iar utf8 este și el un alias acceptat. Problemele apar la greșeli de scriere, la _ în loc de - și la spații.
Erori înrudite
java.nio.charset.MalformedInputException: Input length = 1 Citești ca UTF-8 un text salvat în altă codificare (de obicei Windows-1252, ISO-8859-1 sau Windows-1250, de la Excel ori de la un program vechi), iar un octet nu formează un caracter UTF-8 valid. Citește fișierul cu codificarea în care a fost salvat sau salvează-l din nou ca UTF-8. error: unreported exception Exception; must be caught or declared to be thrown Apelezi o metodă care poate arunca o excepție verificată (checked), iar codul tău nici nu o prinde, nici nu o declară. Pune apelul într-un try/catch sau adaugă throws NumeExceptie la metoda care face apelul. java.util.MissingResourceException: Can't find bundle for base name mesaje, locale en_US ResourceBundle.getBundle nu găsește fișierul de traduceri (mesaje.properties) sau clasa cu numele dat: nume greșit, fișier în alt folder sau lipsă din classpath. Pune mesaje.properties în src/main/resources și folosește exact numele lui, fără extensie. Î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.
