UnsatisfiedDependencyException Java Origin: Application & API Last updated 13 Oct 2026

UnsatisfiedDependencyException / NoSuchBeanDefinitionException: No qualifying bean of type 'X' available

Spring couldn’t find (or choose) a bean to inject.

Exact message you may see No qualifying bean of typerequired a bean of type
Explore the map of this error Full error map →
Seen on: Java

Meaning

The class isn’t a Spring bean (missing @Service/@Component), it’s outside the component-scan package, an auto-configuration didn’t activate, or several beans match without a qualifier.

Common causes

  • Missing @Component/@Service/@Repository
  • Class outside the main application package (component scan)
  • Multiple candidates without @Primary/@Qualifier
  • Conditional auto-config not active (missing property/dependency)

⚡ Quick fix

  1. Annotate the class or declare a @Bean
  2. Move it under the @SpringBootApplication package
  3. Add @Primary or @Qualifier

Detailed fix by platform

Java

  1. Run with --debug to print the auto-configuration report

How to diagnose

  1. Bean — Which type is missing?
  2. Scan — Is it in a scanned package?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

circular references — The dependencies of some of the beans in the application context form a cycle (Java)circular referencesDataSource url not specified — Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured. (Java)DataSource url not sp…HttpMessageNotReadableException — HttpMessageNotReadableException: JSON parse error / Required request body is missing (Java)HttpMessageNotReadabl…InvalidOperationException — InvalidOperationException: Unable to resolve service for type 'X' while attempting to activate 'Y' (.NET)InvalidOperationExcep…MethodArgumentNotValidException — MethodArgumentNotValidException: Validation failed for argument [0] (Java)MethodArgumentNotVali…NullInjectorError — Angular: NullInjectorError: No provider for X! (Angular)NullInjectorErrorPort 8080 in use — Web server failed to start. Port 8080 was already in use. (Java)Port 8080 in useWhitelabel Error Page — Whitelabel Error Page — This application has no explicit mapping for /error (Java)Whitelabel Error PageUnsatisfi…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.