java.lang.IllegalArgumentException: Illegal group reference
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
String mesaj = "Total: SUMA".replaceAll("SUMA", "25$");String mesaj = "Total: SUMA".replace("SUMA", "25$");replace nu folosește regex și pune textul exact, inclusiv $.
2Valoare de la utilizator folosită ca înlocuire
String sablon = "Parola noua: P";
String rezultat = sablon.replaceAll("P", parola);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
String cale = "DIR".replaceAll("DIR", "C:\\date\\");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ă 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$.
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);
}
}Oferta: laptop la 899$
Indiciu
Ai nevoie de înlocuire de text simplu, nu de regex: folosește replace.
Reparația
public class Main {
public static void main(String[] args) {
String sablon = "Oferta: PRODUS la PRET";
String pret = "899$";
String mesaj = sablon.replace("PRODUS", "laptop").replace("PRET", pret);
System.out.println(mesaj);
}
}De ce merge
În textul de înlocuire al lui replaceAll, $ anunță o referință la un grup din regex, iar 899$ nu are după $ niciun număr de grup. replace lucrează cu text simplu: caută exact PRET și pune exact 899$, cu tot cu simbolul dolarului. Înlocuiește toate aparițiile, ca și replaceAll.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Illegal group reference: group index is missingjava.lang.IllegalArgumentException: character to be escaped is missingjava.lang.IllegalArgumentException: No group with name {pret}
Cum o eviți pe viitor
- Folosește
replacecând înlocuiești text fix: înlocuiește tot, la fel careplaceAll, dar fără regex. - Folosește
replaceAlldoar când chiar ai nevoie de expresii regulate sau de grupuri ($1). - Orice text venit din exterior pus ca înlocuire în
replaceAlltrece prinMatcher.quoteReplacement. - Pentru șabloane de mesaje,
String.formatsau"...".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
java.lang.IllegalStateException: No match found Ai apelat matcher.group() fără să fi apelat înainte find() sau matches(), sau după ce acestea au întors false. Apelează if (m.find()) { m.group(1) ... } și citește grupurile doar când există o potrivire. java.util.regex.PatternSyntaxException: Dangling meta character '+' near index 0 Ai dat unei metode care primește o expresie regulată (split, replaceAll, matches) un caracter special (+, *, ?) fără nimic înaintea lui, de obicei split("+"). Escapează-l cu "\\+", pune-l între paranteze drepte "[+]" sau folosește Pattern.quote("+"). error: illegal escape character Într-un String ai un backslash \ urmat de o literă pe care Java nu o cunoaște ca secvență specială, de obicei într-o cale Windows ("C:\Users") sau într-un regex ("\d"). Scrie backslash-ul dublat: \\. Î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.
