...
Eroare Java · Reflecție, module și alte API-uri

java.util.MissingResourceException: Can't find bundle for base name mesaje, locale en_US

Pe scurt

ResourceBundle.getBundle nu găsește fișierul de traduceri (mesaje.properties) sau clasa cu numele dat: nume greșit, fișier în alt folder sau lipsă din classpath. Pune mesaje.properties în src/main/resources și folosește exact numele lui, fără extensie.

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

Ce înseamnă

ResourceBundle.getBundle("mesaje") caută texte traduse pentru limba curentă, de exemplu mesaje_ro.properties, mesaje_en_US.properties, apoi varianta implicită mesaje.properties. Le caută în classpath, nu pe disc relativ la folderul curent. Poate găsi și o clasă cu același nume care extinde ResourceBundle. Dacă nu găsește nimic, aruncă MissingResourceException: Can't find bundle for base name mesaje, locale en_US.

Cauze frecvente:

  • fișierul e în src/main/java sau în rădăcina proiectului, nu în src/main/resources;
  • numele diferă: Mesaje față de mesaje, sau ai scris mesaje.properties (cu extensie) ca nume de bază;
  • fișierul e într-un subfolder, iar numele de bază nu îl include: corect e i18n/mesaje sau i18n.mesaje;
  • fișierul nu e copiat în build (verifică target/classes sau build/resources).

O eroare diferită, Can't find resource for bundle ..., key ..., înseamnă că fișierul a fost găsit, dar cheia lipsește din el.

De ce apare: cauzele frecvente

1Fișier pus în folderul greșit

Greșit
JAVA
src/main/java/mesaje.properties
ResourceBundle.getBundle("mesaje");
Corect
JAVA
src/main/resources/mesaje.properties
ResourceBundle.getBundle("mesaje");

Maven și Gradle copiază în classpath fișierele din resources.

2Numele de bază cu extensie

Greșit
JAVA
ResourceBundle.getBundle("mesaje.properties");
Corect
JAVA
ResourceBundle.getBundle("mesaje");

Numele de bază nu include nici extensia, nici sufixul de limbă.

3Fișier într-un subfolder

Greșit
JAVA
src/main/resources/i18n/mesaje.properties
ResourceBundle.getBundle("mesaje");
Corect
JAVA
src/main/resources/i18n/mesaje.properties
ResourceBundle.getBundle("i18n/mesaje");

Calea din classpath face parte din numele de bază.

Repară tu

Repară eroarea, direct în pagină

Aplicația citește mesajul de bun venit dintr-un pachet de traduceri, dar se oprește cu MissingResourceException: Can't find bundle for base name mesaje, locale en_US. În editor, pachetul nu e un fișier .properties, ci clasa publică Main.Mesaje, al cărei nume binar este Main$Mesaje. Folosește acest nume de bază, ca programul să afișeze Bun venit, Ana!.

Codul care dă eroarea
JAVA
import java.util.ListResourceBundle;
import java.util.ResourceBundle;

public class Main {
    public static class Mesaje extends ListResourceBundle {
        protected Object[][] getContents() {
            return new Object[][] {{"salut", "Bun venit"}};
        }
    }

    public static void main(String[] args) {
        ResourceBundle texte = ResourceBundle.getBundle("mesaje");
        System.out.println(texte.getString("salut") + ", Ana!");
    }
}
După reparație, programul afișează
Bun venit, Ana!
Indiciu

Numele de bază trebuie să corespundă exact pachetului existent: Main$Mesaje.

Alte forme ale mesajului

  • java.util.MissingResourceException: Can't find bundle for base name messages, locale ro_RO
  • java.util.MissingResourceException: Can't find bundle for base name i18n/mesaje, locale en_US
  • java.util.MissingResourceException: Can't find bundle for base name Mesaje, locale ro

Cum o eviți pe viitor

  • Ține fișierele de traduceri în src/main/resources, într-un singur loc.
  • Folosește un fișier implicit mesaje.properties, pe lângă cele pe limbi, ca să existe mereu o variantă de rezervă.
  • Scrie numele de bază într-o constantă și refolosește-o.
  • Verifică după build că fișierul apare în target/classes (Maven) sau build/resources/main (Gradle).

Întrebări frecvente

De ce apare locale en_US, deși eu sunt în România?

Mesajul arată limba implicită a JVM-ului pe care rulează programul (setările sistemului sau -Duser.language). Pe servere, de multe ori e en_US.

Funcționează din IDE, dar nu din JAR. De ce?

Probabil fișierul nu e inclus în JAR. Verifică dacă e în resources și dacă unealta de build îl copiază; IDE-ul uneori pune în classpath și alte foldere.

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.