...
Eroare Spring Boot · Configurare, proprietăți și profiluri

Bean method 'cacheProduse' in 'CacheConfig' not loaded because @ConditionalOnProperty (app.cache.activ=true) did not find property 'app.cache.activ'

Pe scurt

Un bean este creat doar dacă o proprietate are o anumită valoare (@ConditionalOnProperty), iar proprietatea lipsește. Cine îl injectează nu-l găsește. Setează proprietatea, folosește matchIfMissing = true sau oferă un bean alternativ.

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

Ce înseamnă

@ConditionalOnProperty(name = "app.cache.activ", havingValue = "true") pe o metodă @Bean sau pe o clasă înseamnă: creează bean-ul doar dacă proprietatea are valoarea true. Dacă proprietatea lipsește (și nu ai matchIfMissing = true) sau are altă valoare, bean-ul nu există.

Când alt bean îl cere, pornirea eșuează cu required a bean of type 'CacheProduse' that could not be found, iar Spring Boot adaugă, sub The following candidates were found but could not be injected:, explicația din titlu: ce metodă nu s-a încărcat și ce condiție a picat. Același raport îl primești pentru @ConditionalOnMissingBean, @ConditionalOnClass, @Profile.

Ca să vezi toate condițiile evaluate, pornește aplicația cu --debug: raportul CONDITIONS EVALUATION REPORT arată ce s-a configurat și de ce.

De ce apare: cauzele frecvente

1Proprietatea lipsește

Greșit
JAVA
@Bean
@ConditionalOnProperty(name = "app.cache.activ", havingValue = "true")
CacheProduse cache() { ... }
# app.cache.activ nu e setată
Corect
JAVA
@Bean
@ConditionalOnProperty(name = "app.cache.activ", havingValue = "true", matchIfMissing = true)
CacheProduse cache() { ... }

matchIfMissing = true face bean-ul activ implicit; îl dezactivezi explicit cu app.cache.activ=false.

2Nu există variantă pentru cazul dezactivat

Greșit
JAVA
// doar CacheProduse condiționat
ProdusService(CacheProduse cache) { }
Corect
JAVA
@Bean @ConditionalOnMissingBean
CacheProduse fataCache() { return new CacheGol(); }

Un bean de rezervă garantează că dependența există în orice configurare.

Repară tu

Repară eroarea, direct în pagină

CacheProduse se creează doar când app.cache.activ=true, proprietate care lipsește, iar aplicația nu pornește. Fă cache-ul activ implicit, dacă proprietatea lipsește, fără să o adaugi în configurare, ca GET /cache să răspundă Cache activ.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import org.springframework.context.annotation.*;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

class CacheProduse {
    String stare() {
        return "Cache activ";
    }
}

@Configuration
class CacheConfig {
    @Bean
    @ConditionalOnProperty(name = "app.cache.activ", havingValue = "true")
    CacheProduse cacheProduse() {
        return new CacheProduse();
    }
}

@RestController
class CacheController {
    private final CacheProduse cache;

    CacheController(CacheProduse cache) {
        this.cache = cache;
    }

    @GetMapping("/cache")
    String cache() {
        return cache.stare();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /cache → 200
Cache activ
Indiciu

@ConditionalOnProperty are un atribut pentru cazul în care proprietatea lipsește.

Alte forme ale mesajului

  • did not find property 'app.cache.activ'
  • found different value in property 'app.cache.activ'

Cum o eviți pe viitor

  • Pentru funcționalități opționale, oferă mereu o variantă implicită (un bean „gol”) sau fă dependența opțională (Optional<CacheProduse>).
  • Alege conștient matchIfMissing: activ implicit sau inactiv implicit.
  • Rulează cu --debug când un bean condiționat nu apare: raportul de condiții arată motivul.

Întrebări frecvente

Ce compară havingValue?

Textul proprietății, fără să țină cont de majuscule. Fără havingValue, condiția e adevărată pentru orice valoare în afară de false.

Unde văd raportul de condiții?

Pornește aplicația cu --debug sau debug=true în application.properties; raportul apare în log la pornire.

Erori înrudite

← Toate erorile Spring Boot

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ță Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.