...
Eroare Java · Metode, clase și excepții verificate

error: unreported exception Exception; must be caught or declared to be thrown

Pe scurt

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 sunt RuntimeException (IOException, InterruptedException, excepțiile tale care extind Exception). 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

Greșit
JAVA
static void retrage(int suma) {
    if (suma > sold) {
        throw new Exception("Sold insuficient");
    }
}
Corect
JAVA
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

Greșit
JAVA
public static void main(String[] args) {
    retrage(500);
}
Corect
JAVA
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

Greșit
JAVA
class StocEpuizat extends Exception { }
...
throw new StocEpuizat();
Corect
JAVA
class StocEpuizat extends RuntimeException { }
...
throw new StocEpuizat();

Dacă nu vrei să obligi apelanții să o trateze, o faci unchecked, extinzând RuntimeException.

Repară tu

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.

Codul care dă eroarea
JAVA
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);
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • error: unreported exception IOException; must be caught or declared to be thrown
  • error: unreported exception InterruptedException; must be caught or declared to be thrown
  • error: 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 catch gol: 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

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