...
Eroare Java · Fluxuri I/O, codificări și compresie

java.nio.charset.UnsupportedCharsetException: UFT-8

Pe scurt

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") și text.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

Greșit
JAVA
Charset cs = Charset.forName("UFT-8");
Corect
JAVA
Charset cs = StandardCharsets.UTF_8;

Constanta e verificată de compilator și nu aruncă niciodată excepție.

2Numele constantei folosit ca text

Greșit
JAVA
String s = new String(octeti, "UTF_8");
Corect
JAVA
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

Greșit
JAVA
Charset cs = Charset.forName(config.get("encoding")); // " UTF-8"
Corect
JAVA
Charset cs = Charset.forName(config.get("encoding").strip());

Un spațiu face numele invalid (IllegalCharsetNameException). strip() curăță valoarea.

Repară tu

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!.

Codul care dă eroarea
JAVA
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));
    }
}
După reparație, programul afișează
Octeti: 6
Text: Salut!
Indiciu

Înlocuiește Charset.forName("UFT-8") cu StandardCharsets.UTF_8.

Alte forme ale mesajului

  • java.io.UnsupportedEncodingException: UTF_8
  • java.nio.charset.IllegalCharsetNameException: UTF 8
  • java.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, nu String: 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

← Toate erorile Java

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