NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central, #153 by repository stars
Spring Framework API Docs
Latest stable
7.0.9
Last release 3 months ago
21 Aug 2026
Ships unpredictably
gaps range from 4 weeks to 2.2 years
Nearly every release is documented
notes for 12 of 12 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
13 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
The default constructor with the existing behaviour of checking both types of headers is still available but deprecated and marked for removal. The ne…
ForwardedHeaderFilter (Spring MVC) and ForwardedHeaderTransformer (WebFlux) each require a boolean argument whether to use the standard "Forwarded" header or the "X-Forwarded" alternative headers. A separate property enables use of "X-Forwarded-Prefix" if needed. The default constructor with the existing behaviour of checking both types of headers is still available but deprecated and marked for removal. The new constructor makes forwarded header processing more deterministic and aligned with what is expected from the proxy. Please, see the updated Security Considerations section, as well as related changes in Spring Boot spring-projects/spring-boot#51030. #37072@ContextConfiguration #31456AbstractFactoryBean #37091FullyQualifiedConfigurationBeanNameGenerator #37038ExponentialBackOff #36943ClassNotFoundException for missing class resource in ThrowawayClassLoader #36938isAssignableFrom() with isInstance() where feasible #36899DataSize converters to DefaultConversionService #36830ObservationThreadLocalAccessor when a test has an active ApplicationContext #36817ApplicationContext #36782String#replace instead of String#replaceAll where appropriate #36678Date copies for SimpleMailMessage sentDate #36626StandardMethodMetadata with ASM/ClassFile support for getReturnTypeName() #36619BeanRegistrarDsl #36601TypeNotPresentException during annotation processing #36593methodIdentification() method in CacheAspectSupport #36560ResolvableType.forParameter() factory method #36545Assert.notNull() checks in ResolvableType #36544ParameterResolutionDelegate #36534HttpMethod.valueOf() #36518classpath*: support for ResourceLoader#getResource with fully specified resource path #36415Optional with null-safe and Elvis operators #36330@PersistenceAgent injection #36264doPatch() method in FrameworkServlet #36247@BootstrapWith annotation to override a meta-annotation within the same composed annotation #35938BeanRegistrar #21497@MockitoBean and @MockitoSpyBean on test constructor parameters #36096AnnotationDescriptor.findAllLocalMergedAnnotations fails to find interface annotations #36975InputStream in ThrowawayClassLoader #36933@RequestBody deserialization) #36890DefaultMvcResult when catching InterruptedException #36876Thank you to all the contributors who worked on this release:
@PaulNgo-BlueOC, @arnabnandy7, @bebeis, @codingkiddo, @cookie-meringue, @daguimu, @dominik-kovacs, @jhan0121, @junhyeong9812, @leestana01, @mkurz, @ngocnhan-tran1996, @quaff, @s-chan-o, @samueldlightfoot, @seregamorph, @shenjianeng, and @yeomin4242
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Host header initialization breaking change in StompRelayMessageBrokerHandler #36907
ForwardedHeaderFilter (Spring MVC) and ForwardedHeaderTransformer (WebFlux) each provide a boolean constructor argument whether to use the standard "Forwarded" header or the "X-Forwarded" alternative headers. A separate property turns on and off use of "X-Forwarded-Prefix". While the default constructor preserves the existing behavior, we recommend to use the new constructor to explicitly specify which forwarded headers to use to make the processing more deterministic and aligned with what is expected from the proxy. Please, see the updated Security Considerations section for details. In 7.1 with #37072 the default constructor is deprecated and marked for removal. #37090SimpleEvaluationContext no longer supports expression compilation by default, regardless of the compiler mode configured via SpelParserConfiguration or the spring.expression.compiler.mode system property or Spring property. Applications that intentionally use SimpleEvaluationContext with trusted expressions and require compilation for performance reasons can opt in by calling withCompilationSupported() on the SimpleEvaluationContext builder. Care should be taken when opting in to compilation, as doing so removes the safety guards applied during interpreted evaluation. #37035@Nullable annotations when treating Map.remove() as returning @Nullable #37067AbstractNestablePropertyAccessor #37036SimpleEvaluationContext #37035BigDecimal/BigInteger power operations in SpEL #37034getSession(*) in MockHttpServletRequest #36926domainToAscii with current WhatWG spec #37018ButtonTag value attribute processing #37017InlineList is cached as a mutable list in compiled mode #37001Indexer reuses invalid cached PropertyAccessor #36986ConstructorExecutor #36985MimeTypeUtils raises StringIndexOutOfBoundsException for some invalid mime types #36971ExponentialBackOff jitter #36932@ActiveProfiles ordering #36950Thank you to all the contributors who worked on this release:
@ZaMan0806, @alexisgra, @alshain, @gianmarcoschifone, @junhyeong9812, @msridhar, @perovic, @quaff, and @samueldlightfoot
Defensive PersistenceExceptionTranslator bean retrieval in PersistenceExceptionTranslationInterceptor on shutdown #33067
PersistenceExceptionTranslator bean retrieval in PersistenceExceptionTranslationInterceptor on shutdown #33067DisconnectedClientHelper #33064@Autowired @Bean method with @Value parameter #33030Thank you to all the contributors who worked on this release:
@tafjwr
CRaC: ignore checkpointOnRefresh afterRestore #32978
@TenantId #32967canEncode() for JAXBElement in Jaxb2XmlEncoder #32977@Valid annotations on container elements for handler argument validation not supported #32964StringUtils#cleanPath #32962@CacheEvict condition uses wrapper comparison instead of actual objects #32960ReactorResourceFactory not working with CRaC onRefresh checkpoint #32945Integer #32908Map with a primitive #32903@EnableTransactionManagement(mode = AdviceMode.ASPECTJ) #32882RegisterReflectionForBinding Javadoc #32947MethodValidationPostProcessor is missing a static keyword #32929KotlinDetector.isKotlinType documentation for Kotlin 2.x lambdas #32905Thank you to all the contributors who worked on this release:
@Attacktive, @Seungpang, @deblockt, @hlmg, @ozooxo, @soglad, and @ypyf
Suppress deprecation warning for AOT-generated code that refers to a deprecated bean type #32850
@DateTimeFormat(iso = DateTimeFormat.ISO.DATE\_TIME) cannot convert UTC without milliseconds to java.util.Date #32856@Configurable aspect #32838Thank you to all the contributors who worked on this release:
@rwinch
ResponseEntity is not reliably closed with InputStreamResource #32802
@Aspect classes for Spring AOP proxy usage #32793AnnotationConfigWebApplicationContext should propagate ApplicationStartup to BeanFactory #32747PropertiesPropertySource.getPropertyNames() #32742MergedAnnotations search does not find container for repeatable annotation #32731ScopedProxyMode.TARGET\_CLASS and advisors #32669ResponseCookie #32663Flux<T> return values #32630factory-method does not always determine correct target type #32091@Order behavior on types, bean methods, and config classes #30177@Transactional re-entrant calls) #28299Thank you to all the contributors who worked on this release:
@LeMikaelF, @Seungpang, @izeye, @m4tt30c91, @remeio, and @yhao3
Log column type for limited support message in JdbcUtils.getResultSetValue #32601
JdbcUtils.getResultSetValue #32601FactoryBean type matching when using getBeanProvider #32590@RequestParam binding does not support params with an empty array "[]" suffix #32577Annotation array cloning in TypeDescriptor #32476Annotation array in TypeDescriptor #32405MethodIntrospector.selectMethods() fails to detect bridge methods across ApplicationContexts #32586CompoundExpression omits null-safe syntax in AST string representation of null-safe selection/projection in SpEL #32515FactoryBean class not autowired in case of targetType mismatch #32489HeaderContentNegotiationStrategy.resolveMediaTypes() throws unexpected InvalidMimeTypeException #32483Thank you to all the contributors who worked on this release:
@Banuelorigni, @LinorDolev, @T45K, @izeye, @kilink, @quaff, and @qww1552
Extract reusable method for URI validations #32440
ServletServerHttpResponse #32361\*HttpMessageConverter#getContentLength return value null safety #32325boolean array #32400@Cacheable #32370ServletResponseHttpHeaders#get null handling #32362#root or #this is a non-public type #32356value class parameters #32353constructor-impl of Kotlin value class is not called #32324HHH-17643 #32311@Sql execution phases regarding lifecycle #32343TransactionAspectSupport.currentTransactionStatus().transactionName #32310@RequestScope and similar use cases) #32287userDestinationPrefix in MessageBrokerRegistry #32272Thank you to all the contributors who worked on this release:
@Xednar, @ZeroCyan, @bsgrd, @ddaaac, @kilink, @qeeqez, and @quaff
Add missing RequestPredicate variants in coRouter #32256
SpelMessage.INCORRECT\_NUMBER\_OF\_ARGUMENTS\_TO\_FUNCTION #32239NonReactiveHandlerMethodPredicate #32227phase value configurable in STOMP message handling components #32205BeanPropertyRowMapper subclasses customize mapped names #32199JdbcClient #32161@FunctionalInterface #32135SimpleJdbcInsert with catalog name #32124MapPropertySource for DynamicValuesPropertySource implementation (as a template for custom variants) #32110validationGroups every time the call is made #32068@RequestMapping and @HttpExchange declarations on the same element #32065@HttpExchange declarations on the same element #32049@PostMapping, @GetMapping, etc. annotations are declared #31962@SessionAttributes is sometimes not reflected in the model #30463pathExtension null-safety in Kotlin DSLs #32254SimpleEvaluationContext.Builder is not final and has a public constructor #32253@JsonDeserialize(builder = ...) does not work in GraalVM native image #32238toString() in HandlerMethod from 6.1.3 #32184Indexer.setArrayElement() incorrectly requests conversion to wrapper instead of primitive #32147PartEventHttpMessageReader#maxParts is off by one #32122RestClient calls interceptors from RestTemplate twice #32038DefaultRestClientBuilder.defaultRequest(...) doesn't do anything #32028SimpleAliasRegistry is misleading #32025ExecutorService Bean type #32006RequestPredicate fails with WebFlux 6.1.2 #31955@RequestAttribute in HTTP clients #32231between operator in SpEL #32140String operators in SpEL #32137@Scheduled tasks #32109@see PathPattern to function router methods with a pattern parameter #32045class-data-sharing.html to cds.html #32044@JvmName could mitigate Kotlin internal modifier impact #32010@HttpExchange to make it more clear when it is a good fit #32008Thank you to all the contributors who worked on this release:
@1515biubiubiu, @Akaame, @OlgaMaciaszek, @andreibastun, @cirusthenter, @erichaagdev, @jee14, @jmondo, @kilink, @kzander91, @mnhock, @quaff, @rotilho, @rwinch, @senocak, @spencergibb, and @wfouche
Perform checks for bean validation constraints in HandlerMethod only when needed #32007
processInjection() in CommonAnnotationBeanPostProcessor #31956ApplicationContext configurable #31952JdkClientHttpRequest may block indefinitely #31911Propagation.NOT\_SUPPORTED with @TransactionalEventListener #31907MaxUploadSizeExceededException #31850@Resource in test classes in AOT mode #31733SpringValidatorAdapter fails in getRejectedValue if ValueExtractor used in property path to unwrap a container type #29043@Scheduled tasks in test setups #28073@annotation pointcut is not matched with complex hierarchy and generics against classes compiled by Eclipse [SPR-17310] #21843WebClient causes an IllegalStateException #32003RestClientResponseException handles responseHeaders case-sensitive #31978WebClient URI template attribute since Spring WebFlux 6.1.2 #31882@Async does not support Unit? return type #31881@Cacheable does not respect cache hit when empty Mono/Flux response is returned #31868NullPointerException with @RequestMapping on Kotlin property accessors #31856StringDecoder when splitting input by delimiters. #31848ConstraintViolation property path and BindingResult target in MethodValidationAdapter #31746@RequestBody parameter twice #31711ProceedingJoinPoint.proceed when called from within another advised bean #26068RestClient and RestTemplate #31991ContentRequestMatchers#multipartData Javadoc #31988internal modifier impact on @Bean #31985Jackson2ObjectMapperBuilder documentation to mention ParameterNamesModule registration #31959autowired-qualifiers.adoc to refer the -parameters Java compiler flag #31939CoWebFilter #31877@Transactional in reactive environments with non-reactive signatures #23277Thank you to all the contributors who worked on this release:
@0x1306e6d, @Drezir, @FBibonne, @JuHyun419, @OlgaMaciaszek, @SuhasBk, @T45K, @Yaklede, @aaronrosser, @achhibi, @bohub12, @dodie, @dogglezz, @izeye, @janjouketjalsma, @kzander91, @leonchen83, @pri88yank, @quaff, @scordio, @slovenlyimp, and @wfouche
Optimize ContentCachingRequestWrapper allocation for known request size #31834
coRouter DSL #31831isStatic and releaseTarget as default methods on TargetSource #31820MySQLIdentityColumnMaxValueIncrementer #31784MockPart constructor that accepts the Content-Type #31757toString(Charset) in FastByteArrayOutputStream #31737TestExecutionListeners at WARN level #31688-parameters flag in exception messages #31675@RegisterReflectionForBinding for enums #31570@Resource @Lazy fallback autowiring #31447@Order) #30849SimpleJdbcCall named parameter binding for Sybase ASE #30231@Async aspect should clear cached executors when different BeanFactory set #28201ServletCookieValueMethodArgumentResolver #26989Predicate- based mappedHandler config in AbstractHandlerExceptionResolver #26772SimpleJdbcCall with namedBinding=true for MS SQL Server #26072setNull performance on PostgreSQL and MS SQL Server (e.g. for NamedParameterJdbcTemplate batch updates) #25679<replaced-method /> unnecessarily requires explicit arg-type since 6.0 #31826MergedAnnotations finds duplicate annotations on method in multi-level interface hierarchy #31803@Cacheable key generator is called after invoking the cached method in case of a miss #31789NotSerializableException for HttpComponentsHeadersAdapter when serializing HttpClientErrorException #31787Part from nested constructor binding in WebFlux #31778MimeTypeUtils.sortBySpecificity() #31769AnnotatedTypeMetadata's getMergedRepeatableAnnotationAttributes() method ignores classValuesAsString #31768ServerRequest::pathVariable in nested RequestPredicate again #31732@NotNull on JPA entity not respected in schema generation #31726@Cacheable throws NullPointerException when encountering cached null value for empty Mono #31722null if no response body is available #31719Duration argument if request parameter is not present #31709@ComponentScan added directly and via a meta-annotation leads to multiple scanning #31704@DisabledInAotMode does not work in native image #31705Query.scroll() in SharedEntityManagerCreator's queryTerminatingMethods set #31682equals method (for ConversionService caching) #31672RequestMappingInfo leads to "IllegalArgumentException: Expected lookup path" #31662@Resource dependency injection fails with AOT/native #29614ReflectiveMethodResolver #28377DatabaseMetadata#getProcedures (and functions) should take search string escape into account #22725@HttpExchange section of reference docs #31796#this and #root variable examples in SpEL documentation #31770@ModelAttribute is required for reflection hints inference #31765MockRestServiceServer.bindTo(RestClient.Builder) #31741-Dspring.context.exit=onRefresh for Project CRaC testing purpose #31724spring.factories used in the TestContext framework in the reference manual #31723Thank you to all the contributors who worked on this release:
@HeartPattern, @HyeongMokJeong, @Johannes-Rost, @JuHyun419, @Nijco, @cdalexndr, @dogglezz, @freesme, @giuseppemilicia, @hpoettker, @izeye, @kilink, @lugaramirez, @mathieu-amblard, @meedbek, @perlun, @quaff, @reda-alaoui, @shin-mallang, and @tylerbertrand
Skip buffer allocation in StreamUtils.copy(String) #31621
StreamUtils.copy(String) #31621Cache.retrieve(key) semantics #31637<jee:local-slsb> no longer works with a business-interface attribute #31627@Cacheable method does not support condition with #result #31626PathResourceResolver.getResource() does not log warning if Resource#getURL() throws exception #31623Thank you to all the contributors who worked on this release:
@7fantasy7, @Star-ho, and @quaff
When using Oracle, JdbcClient.update(KeyHolder) does not work without explicit key column names #31607
JdbcClient.update(KeyHolder) does not work without explicit key column names #31607@EmbeddableInstantiators registered on JPA embeddables for reflection #31534ControlFlowPointcut #31435@EnableJpaAuditing using Spring Boot 3.2-RC2 in native image #31575RestClient but passes with WebTestClient #31574ExecutorLifecycleDelegate should call ExecutorService.isTerminated() in ?.isRunning() #31549RestTemplate POST to endpoint using Digest Auth no longer works in 6.1 #31516null indexed argument value #31508@Sql scripts and statements #31589@[Enabled|Disabled]InNativeImage in reference manual #31438@DisabledInAotMode in the reference manual #31437@Sql class-level execution phase support in the reference manual #31377Thank you to all the contributors who worked on this release:
@Young-Zen, @duesenklipper, @izeye, @k-seth, and @wakingrufus
On behalf of the team and all contributors, I am pleased to announce that Spring Batch 6.1 is available from Maven Central now! This release brings a…
Mahmoud Ben Hassine · November 19, 2026 Read more →
One column per quarter.