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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Java împarte excepțiile în două familii:
- unchecked:
RuntimeExceptionși subclasele ei (NullPointerException,IllegalArgumentException...). Compilatorul nu te obligă să le tratezi. - checked:
Exceptionși subclasele care nu suntRuntimeException(IOException,InterruptedException, excepțiile tale care extindException). Pentru ele, compilatorul cere să decizi explicit ce faci.
Mesajul unreported exception X; must be caught or declared to be thrown apare când apelezi (sau arunci cu throw) o excepție checked fără una dintre cele două opțiuni:
- o prinzi:
try { ... } catch (X e) { ... }; - o declari:
void metoda() throws X, iar cine apelează metoda primește aceeași obligație.
Partea X din mesaj e numele excepției: Exception, IOException, SoldInsuficientException. Excepțiile proprii care extind Exception sunt checked; dacă extind RuntimeException, nu sunt.
De ce apare: cauzele frecvente
1throw al unei excepții checked fără throws
static void retrage(int suma) {
if (suma > sold) {
throw new Exception("Sold insuficient");
}
}static void retrage(int suma) throws Exception {
if (suma > sold) {
throw new Exception("Sold insuficient");
}
}throws Exception anunță că metoda poate arunca excepția, iar apelantul trebuie să o trateze.
2Apel al unei metode cu throws, fără try/catch
public static void main(String[] args) {
retrage(500);
}public static void main(String[] args) {
try {
retrage(500);
} catch (Exception e) {
System.out.println("Eroare: " + e.getMessage());
}
}Obligația trece la cel care apelează. try/catch o rezolvă și tratează eroarea.
3Excepție proprie care extinde Exception
class StocEpuizat extends Exception { }
...
throw new StocEpuizat();class StocEpuizat extends RuntimeException { }
...
throw new StocEpuizat();Dacă nu vrei să obligi apelanții să o trateze, o faci unchecked, extinzând RuntimeException.
Repară eroarea, direct în pagină
Metoda retrage aruncă o excepție când soldul nu ajunge, dar programul dă error: unreported exception Exception; must be caught or declared to be thrown. Declară excepția și trateaz-o în main, ca programul să afișeze Retras 200, sold 100 și Eroare: sold insuficient.
public class Main {
static int sold = 300;
static void retrage(int suma) {
if (suma > sold) {
throw new Exception("sold insuficient");
}
sold -= suma;
System.out.println("Retras " + suma + ", sold " + sold);
}
public static void main(String[] args) {
retrage(200);
retrage(500);
}
}Retras 200, sold 100 Eroare: sold insuficient
Indiciu
Metoda trebuie să anunțe excepția cu throws, iar main să pună apelurile în try/catch.
Reparația
public class Main {
static int sold = 300;
static void retrage(int suma) throws Exception {
if (suma > sold) {
throw new Exception("sold insuficient");
}
sold -= suma;
System.out.println("Retras " + suma + ", sold " + sold);
}
public static void main(String[] args) {
try {
retrage(200);
retrage(500);
} catch (Exception e) {
System.out.println("Eroare: " + e.getMessage());
}
}
}De ce merge
Exception e o excepție checked, deci compilatorul cere ca metoda care o aruncă să o declare. throws Exception face asta, iar obligația trece la main, unde apelurile sunt puse în try/catch. Prima retragere reușește și lasă soldul la 100; a doua cere 500, aruncă excepția, iar catch afișează mesajul ei.
Alte forme ale mesajului
error: unreported exception IOException; must be caught or declared to be thrownerror: unreported exception InterruptedException; must be caught or declared to be thrownerror: exception IOException is never thrown in body of corresponding try statement
Cum o eviți pe viitor
- Când scrii o excepție proprie, decide de la început: checked (
extends Exception) dacă apelantul trebuie să o trateze, unchecked (extends RuntimeException) dacă e o greșeală de programare. - Tratează excepția acolo unde poți face ceva util (afișezi un mesaj, încerci altă variantă); altfel declar-o cu
throws. - Nu prinde excepții doar ca să scapi de eroare cu un
catchgol: măcar afișează sau loghează mesajul.
Întrebări frecvente
Pot pune throws Exception la main?
Da, compilează, iar dacă excepția apare, programul se oprește cu stiva de apeluri. E acceptabil în exerciții, dar în aplicații reale e mai bine să o tratezi.
De ce NullPointerException nu cere try/catch?
Pentru că e RuntimeException, adică unchecked. Java consideră că acestea indică greșeli în cod, care trebuie reparate, nu prinse peste tot.
Erori înrudite
error: missing return statement Metoda promite că întoarce o valoare (are un tip în loc de void), dar există cel puțin un drum prin cod care se termină fără return. Adaugă un return la final sau pe ramura else care lipsește. error: method aplicaReducere in class Main cannot be applied to given types; Apelezi o metodă cu alt număr sau alt tip de argumente decât are în declarație. Mesajul arată ce cere metoda (required) și ce i-ai dat (found): potrivește apelul cu parametrii. java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. Î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.
