Skip to content
Latchkey

Spring Boot "APPLICATION FAILED TO START" in CI

The "APPLICATION FAILED TO START" banner is Spring Boot's FailureAnalyzer summarizing a startup exception. The real fix is in the "Description" and "Action" lines that follow it, not in the banner itself.

What this error means

A bootRun, java -jar, or @SpringBootTest step prints a large "APPLICATION FAILED TO START" banner with a Description and Action section, then exits non-zero.

Spring Boot
***************************
APPLICATION FAILED TO START
***************************

Description:

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

Action:

Consider the following:
	If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.

Common causes

A startup exception was translated into a friendly report

A FailureAnalyzer caught an exception during context refresh (missing DataSource, unresolved placeholder, bean error) and printed a human-readable Description and Action.

CI environment differs from local

The banner appears in CI because a service, env var, or profile present on your machine is absent on the runner, so a bean or config that works locally now fails.

How to fix it

Read the Description and Action lines

  1. Scroll to the "Description:" block, that is the actual failure.
  2. Apply the "Action:" hint (add a dependency, set a property, define a bean).
  3. Re-run the job and confirm the banner is gone.

Reproduce the same profile and env locally

Run with the CI profile and the same variables so the failure surfaces before push.

Terminal
SPRING_PROFILES_ACTIVE=ci ./gradlew bootRun

How to prevent it

  • Set spring.profiles.active explicitly in CI so config is deterministic.
  • Provide every externalized property the runner needs via env or a ci profile.
  • Read the Action block first, it usually names the exact remedy.

Frequently asked questions

What causes ""APPLICATION FAILED TO START""?
A FailureAnalyzer caught an exception during context refresh (missing DataSource, unresolved placeholder, bean error) and printed a human-readable Description and Action.
How do I fix "APPLICATION FAILED TO START"?
Read the Description and Action lines

Related guides

References

Latchkey auto-heals failures like this one - detected, fixed, and retried without you. Start free → 30-day trial · No credit card