Spring Auto-reconfiguration Framework
December 13, 2025 · View on GitHub
🛑 CRITICAL DEPRECATION NOTICE 🛑
THIS FRAMEWORK IS DEPRECATED AND DISABLED BY DEFAULT
Status: Disabled since December 2025
Reason: Spring Cloud Connectors entered maintenance mode in July 2019
Action Required: MIGRATE TO JAVA-CFENV IMMEDIATELY
See the Migration Guide from Spring Auto-reconfiguration to java-cfenv for step-by-step instructions.
The Spring Auto-reconfiguration Framework causes an application to be automatically reconfigured to work with configured cloud services.
Why This Framework is Deprecated
- Spring Cloud Connectors is in maintenance mode (since July 2019)
- No security updates or bug fixes will be provided
- Not compatible with modern Spring Boot (3.x+)
- Replaced by java-cfenv - the official successor library
Migration Path
| Your Application | Recommended Action |
|---|---|
| Spring Boot 3.x | Migrate to java-cfenv NOW |
| Spring Boot 2.x | Plan migration to java-cfenv when upgrading to Spring Boot 3.x |
| Legacy Spring apps | Consider upgrading to Spring Boot 3.x + java-cfenv |
Re-enabling (NOT RECOMMENDED)
If you absolutely must re-enable this deprecated framework temporarily:
cf set-env my-app JBP_CONFIG_SPRING_AUTO_RECONFIGURATION '{enabled: true}'
cf restage my-app
⚠️ WARNING: This is a temporary workaround only. Plan your migration immediately.
| Detection Criterion | Existence of a spring-core*.jar file in the application directory AND explicitly enabled via configuration |
| Tags | spring-auto-reconfiguration=<version> (only when enabled) |
| Default | DISABLED (as of Dec 2025) |
The Spring Auto-reconfiguration Framework adds the cloud profile to any existing Spring profiles such as those defined in the SPRING_PROFILES_ACTIVE environment variable. It also uses the Spring Cloud Cloud Foundry Connector to replace any bean of a candidate type with one mapped to a bound service instance. Please see the Auto-Reconfiguration project for more details.
Configuration
For general information on configuring the buildpack, including how to specify configuration values through environment variables, refer to Configuration and Extension.
The framework can be configured by modifying the config/spring_auto_reconfiguration.yml file in the buildpack fork. The framework uses the Repository utility support and so it supports the version syntax defined there.
| Name | Description |
|---|---|
enabled | Whether to attempt auto-reconfiguration. Default: false (disabled since Dec 2025) |
repository_root | The URL of the Auto-reconfiguration repository index (details). |
version | The version of Auto-reconfiguration to use. Candidate versions can be found in this listing. |
Enabling Spring Auto-reconfiguration
To enable this deprecated framework, set the environment variable:
cf set-env my-app JBP_CONFIG_SPRING_AUTO_RECONFIGURATION '{enabled: true}'
cf restage my-app
Warning: You will see deprecation warnings in your logs when this framework is enabled.