Skip to content

Spring Boot 3.5.0 RC1 Release Notes

Jump to bottom
Phillip Webb edited this page Apr 25, 2025 · 28 revisions

Spring Boot 3.5.0-RC1 Release Notes

Upgrading from Spring Boot 3.4

Auto-configured TaskExecutor Names

Thus far, Spring Boot auto-configures a TaskExecutor with the taskExecutor and applicationTaskExecutor bean names. As of this release, only the applicationTaskExecutor bean name is provided. Code that is requesting the auto-configured Executor by name should be adapted to use applicationTaskExecutor.

If you relied on this behaviour and cannot change it immediately, the alias can be added using a BeanFactoryPostProcessor, as shown in the following example:

@Configuration
public class MyConfiguration {

    @Bean
    static BeanFactoryPostProcessor taskExecutorAliasBeanFactoryPostProcessor() {
        return (beanFactory) -> beanFactory.registerAlias("applicationTaskExecutor", "taskExecutor");
    }

}

ECS Structured Logging JSON

JSON output for ECS structure logging has been updated to use the nested format. This should improve compatibility with the backends that consume the JSON.

Follow Redirects with TestRestTemplate

The TestRestTemplate now uses the same follow redirects settings as the regular RestTemplate. The HttpOption.ENABLE_REDIRECTS option has also been deprecated.

If the new default settings causes issues with your tests, you can use the TestRestTemplate.withRedirects(…​) method to pick an alternative follow redirects strategy.

Minimum Requirements Changes

None.

New and Noteworthy

Tip
 Check the configuration changelog for a complete overview of the changes in configuration.

AsyncTaskExecutor with Custom Executor

If an Executor bean is present, Spring Boot can now be configured to auto-configure an AsyncTaskExecutor anyway. To do so, set the spring.task.execution.mode property to force.

When running in this mode, it makes sure that all integrations, including regular @Async processing uses the auto-configured executor, unless an AsyncConfigurer bean is defined.

Auto-configuration for Bean Background Initialization

Spring Boot now auto-configures a bean named bootstrapExecutor if it’s not already there. For that to work, there needs to be a bean named applicationTaskExecutor in the context, which is the default if you haven’t defined a custom Executor bean. This enables bean background initialization out of the box.

ClientHttpConnector Builder and Configuration Properties

Users of WebClient can now use properties for global configuration such as timeouts and redirect settings. This feature aligns with the support that we added for blocking clients in Spring Boot 3.4.

In addition to the new properties, the new ClientHttpConnectorBuilder interface can be used for more complex customizations.

Annotations to Register Filter and Servlet

As an annotation-based alternative to ServletRegistrationBean and FilterRegistrationBean two new annotations have been added. @ServletRegistration can be used to register Servlet, while @FilterRegistration can be used to register Filter, as shown in this example:

@Configuration(proxyBeanMethods = false)
class MyConfiguration {

    @Bean
    @FilterRegistration(name = "my-filter", urlPatterns = "/test/*", order = 0)
    MyFilter myFilter() {
        return new MyFilter();
    }

}

Additionally, the behavior of FilterRegistrationBean for empty dispatcher types has been adjusted. Previously, it was possible to pass an empty DispatcherType set into the setDispatcherTypes methods, and this empty set would be passed through to the server. Now it’s the same behavior as calling setDispatcherTypes(null), which aligns it to the FilterRegistration annotation.

OAuth 2 Client Auto-configuration

OAuth 2 Client auto-configuration now applies in more situations and is more granular.

  • OAuth2ClientAutoConfiguration configure OAuth 2 client related beans in anything other than a reactive web application

  • OAuth2ClientWebSecurityAutoConfiguration configures OAuth 2 client based web security in a servlet web application

  • ReactiveOAuth2ClientAutoConfiguration configures reactive OAuth 2 client related beans in anything other than a servlet web application

  • ReactiveOAuth2ClientWebSecurityAutoConfiguration configures OAuth 2 client based web security in a reactive web application

Cloud Native Buildpacks

Ubuntu Noble

The default builder has been switched to paketobuildpacks/builder-noble-java-tiny. The resulting image doesn’t have a shell or other utilities. If you need a shell, you can use paketobuildpacks/ubuntu-noble-run-base as the run image.

Docker Config Authentication

Both the Maven and Gradle plugin will now attempt to use authentication settings from your docker config.json file. This includes support for executing credential helpers to support things like the MacOS keychain.

Miscellaneous

Apart from the changes listed above, there have also been lots of minor tweaks and improvements including:

  • MeterProvider beans are now automatically configured on OtlpHttpLogRecordExporter, OtlpHttpSpanExporter, OtlpGrpcLogRecordExporter and OtlpGrpcSpanExporter.

  • The referral mode for Spring LDAP can be configured with the new spring.ldap.referral property.

  • Customizers for OtlpHttpSpanExporterBuilder and OtlpGrpcSpanExporterBuilder have been added.

  • The new property spring.kafka.consumer.max-poll-interval can be used to configure Kafka’s maximum delay between poll invocations.

  • RECORD_COMPONENT has been removed as a target from @DefaultValue, as it wasn’t really necessary.

  • The auto-configured RestClientSsl bean now builds upon, rather than overwrite, the configuration from HttpClientProperties.

  • RestClientAutoConfiguration now applies for reactive web applications that are using virtual threads and have a applicationTaskExecutor bean.

  • The Auto-configured OtlpMeterRegistry now applies any use provided OtlpMetricsSender bean.

  • It is now possible to set histogram-flavor and max-buckets per meter registry.

  • Additional properties have been added under logging.structured.json.context to allow context data to not be logged, or to be logged in a different location.

  • A new spring.test.print-condition-evaluation-report property has been added that can be set to false if you don’t want the details printed when tests fail.

Deprecations in Spring Boot 3.5.0-RC1

  • The configuration property spring.mvc.converters.preferred-json-mapper has been deprecated. It is replaced by spring.http.converters.preferred-json-mapper.

  • The configuration properties spring.codec.log-request-details and spring.codec.max-in-memory-size have been deprecated. They are replaced by spring.http.codecs.log-request-details and spring.http.codecs.max-in-memory-size respectively.

  • org.springframework.boot.autoconfigure.security.oauth2.client.servlet.OAuth2ClientAutoConfiguration in favor of org.springframework.boot.autoconfigure.security.oauth2.client.OAuth2ClientAutoConfiguration

Pages

Clone this wiki locally