...
Eroare Java · Date calendaristice și expresii regulate

java.lang.IllegalArgumentException: Illegal group reference

Pe scurt

Textul de înlocuire dat lui replaceAll sau replaceFirst conține $ (sau \), pe care Java îl citește ca referință la un grup din regex. Dacă vrei înlocuire de text simplu, folosește replace(), sau protejează textul cu Matcher.quoteReplacement(...).

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

Ce înseamnă

String.replaceAll(regex, inlocuire) tratează ambele argumente special. Primul e o expresie regulată, iar în al doilea, $1, $2 sau ${nume} înseamnă „pune aici ce a prins grupul respectiv”. De aceea un $ urmat de altceva decât un număr sau un nume de grup dă Illegal group reference (sau Illegal group reference: group index is missing, când $ e la final). Un $ urmat de o cifră pentru care nu există grup dă IndexOutOfBoundsException: No group 2.

La fel, \ din textul de înlocuire scapă caracterul următor, iar un \ la final dă character to be escaped is missing.

Problema apare des cu prețuri în dolari, căi Windows sau parole introduse de utilizator. Dacă nu ai nevoie de regex, replace(text, inlocuire) înlocuiește toate aparițiile exact, fără interpretare.

De ce apare: cauzele frecvente

1Preț cu $ în textul de înlocuire

Greșit
JAVA
String mesaj = "Total: SUMA".replaceAll("SUMA", "25$");
Corect
JAVA
String mesaj = "Total: SUMA".replace("SUMA", "25$");

replace nu folosește regex și pune textul exact, inclusiv $.

2Valoare de la utilizator folosită ca înlocuire

Greșit
JAVA
String sablon = "Parola noua: P";
String rezultat = sablon.replaceAll("P", parola);
Corect
JAVA
String sablon = "Parola noua: P";
String rezultat = sablon.replaceAll("P", Matcher.quoteReplacement(parola));

Matcher.quoteReplacement scapă $ și \, ca textul să fie pus exact cum e.

3Cale Windows cu backslash la final

Greșit
JAVA
String cale = "DIR".replaceAll("DIR", "C:\\date\\");
Corect
JAVA
String cale = "DIR".replace("DIR", "C:\\date\\");

Backslash-ul final ar trebui să scape un caracter care nu există. Fără regex, nu mai e special.

Repară tu

Repară eroarea, direct în pagină

Programul completează un șablon de ofertă cu prețul în dolari, dar se oprește cu IllegalArgumentException: Illegal group reference. Repară înlocuirea, ca programul să afișeze Oferta: laptop la 899$.

Codul care dă eroarea
JAVA
public class Main {
    public static void main(String[] args) {
        String sablon = "Oferta: PRODUS la PRET";
        String pret = "899$";
        String mesaj = sablon.replaceAll("PRODUS", "laptop").replaceAll("PRET", pret);
        System.out.println(mesaj);
    }
}
După reparație, programul afișează
Oferta: laptop la 899$
Indiciu

Ai nevoie de înlocuire de text simplu, nu de regex: folosește replace.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Illegal group reference: group index is missing
  • java.lang.IllegalArgumentException: character to be escaped is missing
  • java.lang.IllegalArgumentException: No group with name {pret}

Cum o eviți pe viitor

  • Folosește replace când înlocuiești text fix: înlocuiește tot, la fel ca replaceAll, dar fără regex.
  • Folosește replaceAll doar când chiar ai nevoie de expresii regulate sau de grupuri ($1).
  • Orice text venit din exterior pus ca înlocuire în replaceAll trece prin Matcher.quoteReplacement.
  • Pentru șabloane de mesaje, String.format sau "...".formatted(...) sunt mai clare decât înlocuirile.

Întrebări frecvente

replace înlocuiește doar prima apariție?

Nu. replace înlocuiește toate aparițiile, ca replaceAll. Diferența e că replace lucrează cu text simplu, iar replaceAll cu regex. Pentru prima apariție există replaceFirst, tot cu regex.

Când îmi trebuie $1 în înlocuire?

Când vrei să refolosești o parte din text. De exemplu, "2024-05-01".replaceAll("(\\d+)-(\\d+)-(\\d+)", "$3.$2.$1") dă 01.05.2024.

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.