NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central
Maven Central, #1389 by repository stars
Spring Kafka Test Support
Latest stable
4.1.2
Last release 1 months ago
23 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
255 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Support the delivery attempt header with CommonDelegatingErrorHandler #4786
acknowledge() after a partial batch ack commits only the next record #4726@KafkaListener startup #4591Thank you to all the contributors who worked on this release:
@chuuminggg, @kdelay, @ngocnhan-tran1996, and @ohchanKyu
Your coding agent can read these notes before it upgrades. Set up the MCP server →
AbstractKafkaListenerContainerFactory should allow to configure a KafkaAdmin #4654
Deserializer subclass #4653Serializer subclass #4647@KafkaListener (CompletableFuture / Mono / suspend): in-flight work outlives container stop and races downstream resources shutdown #4519ShareConsumer.clientInstanceId(Duration) for KIP-714 telemetry #4325@KafkaListener: consumer permanently stops fetching partitions it retains across a rebalance #4687@RetryableTopic in tests #4388Thank you to all the contributors who worked on this release:
@Gaurav1112, @kdelay, @ngocnhan-tran1996, and @renechoi
CVE-2026-59317: Harden retry_topic-original-timestamp and backoff timestamp header … #4578
retry_topic-original-timestamp and backoff timestamp header … #4578Thank you to all the contributors who worked on this release:
@cppwfs, @ngocnhan-tran1996, @sobychacko, and @wolfpeyton
KafkaTemplate.receive() returns a record at a different offset when the requested offset is missing #4830
@KafkaListener startup #4802acknowledge() after a partial batch ack commits only the next record #4734@KafkaListener: consumer permanently stops fetching partitions it retains across a rebalance #4696@RetryableTopic in tests #4701CVE-2026-59317: Harden retry_topic-original-timestamp and backoff timestamp header … #4576
retry_topic-original-timestamp and backoff timestamp header … #4576@KafkaListener with two failing records on the same partition skips one of them entirely (never retried, never recovered) #4504Thank you to all the contributors who worked on this release:
@BK202503, @bclozel, @cfcromn, @cppwfs, and @sobychacko
make the method setBackOffFunction work for the batch processing as well #4455
DelegatingDeserializer #4489@RetryableTopic: built-in DLT logging handler fails with "No Acknowledgment available" on 4.0 (works on 3.3.x) #4468@KafkaListener re-delivers a failing record without bound after DefaultErrorHandler retries are exhausted #4465KafkaStreamsDeadLetterDestinationResolver #4430BatchListenerFailedException silently commits offsets for unprocessed records in BatchMessageListener #4436README.md and CONTRIBUTING.adoc #4184Thank you to all the contributors who worked on this release:
@LeosBitto and @ngocnhan-tran1996
Add AcknowledgementCommitCallback support for async share consumer commits #4380
ShareAckMode enum for share consumers #4376group.protocol configuration for Kafka Streams server-side rebalance (KIP-1071) #4329share.acquire.mode (KIP-1206) works through Spring's config model #4326@Nullable annotation for consumer & producer factories #4355Thank you to all the contributors who worked on this release:
@maxwell-balla, @Tarte12, @zooo-code, @loicgreffier, @Arbaz4Sayyad, @Gautam-aman, @jad837
Add RENEW acknowledgment type to ShareAcknowledgment #4322
RENEW acknowledgment type to ShareAcknowledgment #4322@RetryableTopic and RetryTopicConfigurationBuilder with documentation #3706@KafkaListener with programmatic topic resolution #4303@KafkaListener that returns a Mono, the error handler does not retry #4198Thank you to all the contributors who worked on this release:
@sobychacko
Add ackMode attribute to @KafkaListener for per-listener acknowledgment configuration #4174
@KafkaListener for per-listener acknowledgment configuration #4174spring-boot-starter-kafka requirement for Spring Boot 4 #4278transactions.adoc #4271Thank you to all the contributors who worked on this release:
@Lokrip, @RaidThabet, @manhnt27, and @ngocnhan-tran1996
KafkaTemplate.receive() returns a record at a different offset when the requested offset is missing #4831
@KafkaListener startup #4803acknowledge() after a partial batch ack commits only the next record #4733@KafkaListener: consumer permanently stops fetching partitions it retains across a rebalance #4697@RetryableTopic in tests #4702CVE-2026-59317: Harden retry_topic-original-timestamp and backoff timestamp header … #4573
retry_topic-original-timestamp and backoff timestamp header … #4573@KafkaListener with two failing records on the same partition skips one of them entirely (never retried, never recovered) #4515Topic Partition Assignment anchor #4539Thank you to all the contributors who worked on this release:
@BK202503 and @cppwfs
make the method setBackOffFunction work for the batch processing as well #4473
DelegatingDeserializer #4491@RetryableTopic: built-in DLT logging handler fails with "No Acknowledgment available" on 4.0 (works on 3.3.x) #4474spring-boot-starter-kafka requirement for Spring Boot 4 #4464Async Processing (and out of order commits) with FilteringMessageListenerAdapter #4414
@Nullable annotation for consumer & producer factories #4368Listener with async acks pauses indefinitely #4344
@KafkaListener with programmatic topic resolution #4311KafkaMessageListenerContainer.getAssignedPartitions can throw ConcurrentModificationException #4276
Fix reference of deprecated serde APIs in docs #4244
@Serial annotation for serialVersionUID #4236@BackOff does not recognize the __listener placeholder #4232EnableKafka annotations #4239Thank you to all the contributors who worked on this release:
@david-parkk, @jjank, @ngocnhan-tran1996, and @quaff
Allow telling Spring to ignore an argument when identifying the type #4210
@KafkaListener with Both topics and topicPartitions Breaks @RetryableTopic #4170@KafkaListener #4204group.share.delivery.attempt.limit is not a valid configuration param in Kafka Admin API #4194Thank you to all the contributors who worked on this release:
@LEEJaeHyeok97, @kyriakos-kyriakou, @moonyoungCHAE, @ngocnhan-tran1996, and @quaff
Add deleteTopics() method to KafkaAdmin #4155
Thank you to all the contributors who worked on this release:
@cmabdullah, @moonyoungCHAE, @ngocnhan-tran1996, and @snicoll
Add factory-level container properties support to ShareKafkaListenerC… #4112
ShareKafkaMessageListenerContainer #4102DeadLetterPublishingRecoverer constructor signature to accept ? extends KafkaOperations #3913Thank you to all the contributors who worked on this release:
@cfredri4, @ngocnhan-tran1996, and @sobychacko
Allow configuring CompositeBatchInterceptor #4079
@PostConstruct #3954Thank you to all the contributors who worked on this release:
@cfredri4, @moonyoungCHAE, and @sobychacko
Add Jackson 3 support; deprecate Jackson 2 #3930
@RetryableTopic.includeNames and @RetryableTopic.excludeNames #4016Thank you to all the contributors who worked on this release:
@NipponSunrise, @cwangg897, @ngocnhan-tran1996, and @snicoll
Deprecate JUnit 4 utilities in the project #3873
MessagingMessageListenerAdapter #3979@Header. #3880Thank you to all the contributors who worked on this release:
@AlamuriLokesh, @bandalgomsu, @chickenchickenlove, @igormq, @mipo256, @ngocnhan-tran1996, @sh-cho, and @sobychacko
Verify support for the new Consumer Rebalance protocol in Spring Kafka #3847
MessagingMessageListenerAdapter returning null from the DelegatingInvocableHandler.invoke() #3697@KafkaListener listener code #3843Thank you to all the contributors who worked on this release:
@ghgh415263, @ngocnhan-tran1996, @sobychacko, and @sullis
Fix block code in section Examples #3770
build.gradle for building antora #3768CONTRIBUTING and README #3736Thank you to all the contributors who worked on this release:
@cfredri4, @ngocnhan-tran1996, and @sobychacko
make the method setBackOffFunction work for the batch processing as well #4472
DelegatingDeserializer #4492Async Processing (and out of order commits) with FilteringMessageListenerAdapter #4415
Listener with async acks pauses indefinitely #4343
KafkaMessageListenerContainer.getAssignedPartitions can throw ConcurrentModificationException #4275
Duplicated metric "spring.kafka.listener" increment when RetryableTopic enabled #4242
Thank you to all the contributors who worked on this release:
@moonyoungCHAE
Optimize ArrayList allocations in BatchMessagingMessageConverter #4154
Thank you to all the contributors who worked on this release:
@moonyoungCHAE
Bump io.projectreactor:reactor-bom from 2024.0.9 to 2024.0.10 #4086
Fix SpEL/placeholder resolution in @RetryableTopic.includeNames and @RetryableTopic.excludeNames #4030
@RetryableTopic.includeNames and @RetryableTopic.excludeNames #4030Bump io.micrometer:micrometer-bom from 1.14.8 to 1.14.9 #4003
propagate scope in async failures #3957
GH-3712: Make ContainerPausingBackOffHandler working in batch mode. #3887
Enable the tracing on the reply of a ReplyingKafkaTemplate #3826
@KafkaListener listener code #3846Improve performance of acknowledge(int index) / override createRecordList implementation #3767
Using ConcurrentMessageListenerContainer section of reference doc is a bit confusing #3759
Acknowledge+commit always issued in AckMode.MANUAL #3695
@EmbeddedKafka Annotation #3701Thank you to all the contributors who worked on this release:
@bky373
Allow kafka-clients 3.9.x with Spring-Kafka 3.3.x #3662
Thank you to all the contributors who worked on this release:
@bky373, @cfredri4, @omercelikceng, @pszymczyk, and @sobychacko
Some generics optimization in the MessagingMessageListenerAdapter #3620
MessagingMessageListenerAdapter #3620BatchMessagingMessageConverter#processRecord() #3589Thank you to all the contributors who worked on this release:
@JiwonKKang and @bky373
Random behavior in DelegatingByTypeSerializer based on type of delegates map #3976
Enable the tracing on the reply of a ReplyingKafkaTemplate #3827
Kafka ProducerRecord may end up with duplicated trace headers #3792
Optimize a MessagingMessageListenerAdapter returning null from the DelegatingInvocableHandler.invoke() #3711
MessagingMessageListenerAdapter returning null from the DelegatingInvocableHandler.invoke() #3711Change "synchronized" to reentrant lock for virtual-threads #3669
Use Locale.ROOT for locale neutral, case insensitive comparisons #3609
@KafkaListener containerPostProcessor SpEL expression is not being evaluated #3552defaultRetryTopicKafkaTemplate is the default template bean name. @RetryableTopic javadoc says retryTopicDefaultKafkaTemplate #3547Wrong comparison of server bootstrap addresses in KafkaTemplate.afterSingletonsInstantiated #3472
@DltHandler Method to be Defined in a parent class of class annotated with @KafkaListener #3465KafkaAdmin clusterId configuration is ignored when observability is enabled and bootstrap supplier is not set #3446
getUnregisteredListenerContainer return null #3321
Add tracing headers to be mapped to string #3287
Implement CommonErrorHandler.handleOne() in CommonDelegatingErrorHandler #3227
ConsumerFactory and ProducerFactory beans when using Spring Boot is incorrect #3242EmbeddedKafaka#kraft default to false #3238kafkaJaasInitializer bean fails in a read-only filesystem due to creation of temporary file #3217Thank you to all the contributors who worked on this release:
@bky373, @chickenchickenlove, @nachomdo, and @sobychacko
Use Locale.ROOT for locale neutral, case insensitive comparisons #3610
@KafkaListener containerPostProcessor SpEL expression is not being evaluated #3553defaultRetryTopicKafkaTemplate is the default template bean name. @RetryableTopic javadoc says retryTopicDefaultKafkaTemplate #3546Wrong comparison of server bootstrap addresses in KafkaTemplate.afterSingletonsInstantiated #3473
KafkaAdmin clusterId configuration is ignored when observability is enabled and bootstrap supplier is not set #3447
getUnregisteredListenerContainer return null #3322
Add tracing headers to be mapped to string #3288
Implement CommonErrorHandler.handleOne() in CommonDelegatingErrorHandler #3230
ConsumerFactory and ProducerFactory beans when using Spring Boot is incorrect #3244kafkaJaasInitializer bean fails in a read-only filesystem due to creation of temporary file #3219Duplicate record consumption due to offset decrease in last offset commit #3190
default.dsl.store has no effect #3181fix bug at KafkaMessageListenerContainerTests.testInvokeRecordInterceptorAllSkipped() #3094
KafkaMessageListenerContainer doesn't properly clear threadState of AfterRollbackProcessor #3102One column per quarter.