...
Eroare Java · Stiva de apeluri, tablouri și încărcarea claselor

java.io.NotSerializableException: Main$Produs

Pe scurt

Ai serializat un obiect care conține (direct sau într-un câmp) o clasă ce nu implementează Serializable; numele ei apare în mesaj. Adaugă implements Serializable la acea clasă sau marchează câmpul transient dacă nu trebuie salvat.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

ObjectOutputStream.writeObject transformă un obiect în octeți, ca să-l salvezi sau să-l trimiți. Funcționează doar pentru clasele care declară implements Serializable. Regula se aplică întregului graf de obiecte: fiecare câmp care nu e transient sau static trebuie să fie și el serializabil.

Mesajul numește clasa care a blocat procesul: NotSerializableException: Main$Produs. Main$Produs înseamnă clasa Produs declarată în interiorul lui Main. Deseori clasa principală e serializabilă, dar un câmp al ei, de exemplu un Produs sau o listă de Produs, nu e.

Repari punând implements Serializable pe clasa numită în mesaj sau, dacă acel câmp nu trebuie salvat (o conexiune, un logger, un cache), declarându-l transient. Atenție la clasele interioare non-statice: ele țin o referință ascunsă la obiectul exterior, care trebuie și el să fie serializabil.

De ce apare: cauzele frecvente

1Câmp de tip neserializabil

Greșit
JAVA
static class Produs { String nume; }
static class Comanda implements Serializable {
    Produs produs;
}
Corect
JAVA
static class Produs implements Serializable { String nume; }
static class Comanda implements Serializable {
    Produs produs;
}

Serializarea parcurge și câmpurile, deci și Produs trebuie să fie serializabil.

2Câmp care nu trebuie salvat

Greșit
JAVA
static class Sesiune implements Serializable {
    String utilizator;
    StringBuilder jurnal = new StringBuilder();
}
Corect
JAVA
static class Sesiune implements Serializable {
    String utilizator;
    transient StringBuilder jurnal = new StringBuilder();
}

transient exclude câmpul din serializare; după citire va fi null.

3Clasă interioară non-statică

Greșit
JAVA
class Magazin {
    class Produs implements Serializable { }
}
Corect
JAVA
class Magazin {
    static class Produs implements Serializable { }
}

Clasa interioară ține o referință la Magazin, care nu e serializabil. Clasa statică nu are această legătură.

Repară tu

Repară eroarea, direct în pagină

Programul serializează o comandă în octeți și o citește înapoi, dar se oprește cu java.io.NotSerializableException: Main$Produs. Repară clasa numită în mesaj, ca programul să afișeze Comanda refacuta: 2 x pix.

Codul care dă eroarea
JAVA
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;

public class Main {
    static class Produs {
        String nume = "pix";
    }

    static class Comanda implements Serializable {
        int cantitate = 2;
        Produs produs = new Produs();
    }

    public static void main(String[] args) throws Exception {
        ByteArrayOutputStream octeti = new ByteArrayOutputStream();
        try (ObjectOutputStream out = new ObjectOutputStream(octeti)) {
            out.writeObject(new Comanda());
        }
        try (ObjectInputStream in = new ObjectInputStream(new ByteArrayInputStream(octeti.toByteArray()))) {
            Comanda c = (Comanda) in.readObject();
            System.out.println("Comanda refacuta: " + c.cantitate + " x " + c.produs.nume);
        }
    }
}
După reparație, programul afișează
Comanda refacuta: 2 x pix
Indiciu

Și clasa Produs trebuie să implementeze Serializable, pentru că e câmp în Comanda.

Alte forme ale mesajului

  • java.io.NotSerializableException: com.magazin.Produs
  • java.io.NotSerializableException: java.lang.Object
  • java.io.WriteAbortedException: writing aborted; java.io.NotSerializableException: Main$Produs

Cum o eviți pe viitor

  • Când marchezi o clasă Serializable, verifică tipurile tuturor câmpurilor ei.
  • Folosește transient pentru resurse și date calculate.
  • Declară un serialVersionUID în clasele serializabile, ca să eviți incompatibilități între versiuni.
  • Pentru date trimise între aplicații, preferă JSON (de exemplu cu Jackson): e mai ușor de citit și nu depinde de clasele Java.

Întrebări frecvente

De ce String și Integer merg fără nimic în plus?

Pentru că implementează deja Serializable, la fel ca majoritatea claselor de date din JDK, inclusiv ArrayList și HashMap (dacă elementele lor sunt serializabile).

Ce înseamnă $ din numele clasei?

Separă clasa exterioară de cea declarată în interiorul ei: Main$Produs este Produs din Main. Așa sunt numite și fișierele .class generate.

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.