...
Eroare Java · Colecții și Stream API

java.lang.IllegalStateException: Queue full

Pe scurt

Ai apelat add() pe o coadă cu capacitate limitată (ArrayBlockingQueue, LinkedBlockingQueue cu limită) care era deja plină. Folosește offer(), care întoarce false în loc să arunce excepție, și tratează cazul în care nu mai e loc.

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

Ce înseamnă

Cozile din java.util.concurrent, precum ArrayBlockingQueue, au o capacitate fixă, dată la creare. Când e plină, fiecare metodă de adăugare se comportă diferit:

  • add(x) aruncă IllegalStateException: Queue full;
  • offer(x) întoarce false și nu adaugă nimic;
  • put(x) așteaptă până se eliberează un loc (util când alt fir consumă din coadă).

Excepția apare de obicei când un producător adaugă mai repede decât se consumă: comenzi, mesaje, joburi. La cozile cu două capete (LinkedBlockingDeque cu limită) mesajul este Deque full.

În stivă vezi AbstractQueue.add și linia ta. Întrebarea de fond este ce trebuie să se întâmple când nu mai e loc: respingi elementul, aștepți sau mărești capacitatea. Codul trebuie să spună asta explicit.

De ce apare: cauzele frecvente

1add() pe o coadă plină

Greșit
JAVA
BlockingQueue<String> comenzi = new ArrayBlockingQueue<>(2);
comenzi.add("C1");
comenzi.add("C2");
comenzi.add("C3");
Corect
JAVA
BlockingQueue<String> comenzi = new ArrayBlockingQueue<>(2);
for (String c : List.of("C1", "C2", "C3")) {
    if (!comenzi.offer(c)) {
        System.out.println("Respinsa: " + c);
    }
}

offer îți spune prin false că nu mai e loc, iar tu decizi ce faci cu elementul.

2Capacitate aleasă prea mică

Greșit
JAVA
Queue<String> mesaje = new ArrayBlockingQueue<>(10);
// se primesc sute de mesaje deodată
Corect
JAVA
Queue<String> mesaje = new ArrayBlockingQueue<>(1000);
// sau, fără limită: new ArrayDeque<>()

Dacă nu ai nevoie de limită (fără mai multe fire), ArrayDeque sau LinkedList cresc automat.

3Elementele nu sunt scoase din coadă

Greșit
JAVA
coada.add(job);
Job j = coada.peek();
proceseaza(j);
Corect
JAVA
coada.add(job);
Job j = coada.poll();
proceseaza(j);

peek doar se uită la primul element. poll îl și scoate, eliberând locul.

Repară tu

Repară eroarea, direct în pagină

Ghișeul primește clienți într-o coadă cu 3 locuri, iar al patrulea client oprește programul cu IllegalStateException: Queue full. Folosește offer, ca programul să afișeze In coada: Ana, In coada: Dan, In coada: Ioana, Coada plina, revino: Radu și Clienti in coada: 3.

Codul care dă eroarea
JAVA
import java.util.concurrent.*;

public class Main {
    public static void main(String[] args) {
        BlockingQueue<String> coada = new ArrayBlockingQueue<>(3);
        String[] clienti = {"Ana", "Dan", "Ioana", "Radu"};
        for (String c : clienti) {
            coada.add(c);
            System.out.println("In coada: " + c);
        }
        System.out.println("Clienti in coada: " + coada.size());
    }
}
După reparație, programul afișează
In coada: Ana
In coada: Dan
In coada: Ioana
Coada plina, revino: Radu
Clienti in coada: 3
Indiciu

offer întoarce false când coada e plină: verifică rezultatul cu if.

Alte forme ale mesajului

  • java.lang.IllegalStateException: Deque full
  • Exception in thread "main" java.lang.IllegalStateException: Queue full at java.base/java.util.AbstractQueue.add(AbstractQueue.java)

Cum o eviți pe viitor

  • La cozi cu limită, folosește offer și verifică rezultatul, sau put dacă există un consumator pe alt fir.
  • Alege capacitatea după volumul real și decide dinainte ce se întâmplă la depășire.
  • Folosește poll pentru a consuma elemente, nu peek.
  • Pentru o simplă coadă de lucru într-un singur fir, ArrayDeque e suficientă și nu are limită.

Întrebări frecvente

De ce add() aruncă excepție și offer() nu?

Interfața Queue oferă ambele stiluri: metodele add, remove, element aruncă excepții, iar offer, poll, peek întorc o valoare specială (false sau null). Alegi stilul după cât de normală e situația „coadă plină”.

Ce rost are o coadă cu limită?

Protejează memoria: dacă producătorul e mult mai rapid decât consumatorul, o coadă fără limită ar crește până la OutOfMemoryError. Limita te obligă să tratezi supraîncărcarea.

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.