Spring Boot应用中Kafka消费者拦截器未注册且自定义ConsumerConfig被覆盖的问题求助

架构老林

2026-4-15

问题背景

我实现了一个Kafka消费者拦截器类ApiGatewayKafkaConsumerInterceptor，同时配置了KafkaConsumerConfig类来设置消费者属性，包括指定拦截器。但启动应用后发现拦截器并未注册，而且自定义的ConsumerConfig参数也被Kafka覆盖了。

拦截器代码

package com.demo.api.gateway.kafka.interceptor;

import java.util.Map;
import org.apache.kafka.clients.consumer.ConsumerInterceptor;
import org.apache.kafka.clients.consumer.ConsumerRecords;
import org.apache.kafka.clients.consumer.OffsetAndMetadata;
import org.apache.kafka.common.TopicPartition;

public class ApiGatewayKafkaConsumerInterceptor implements ConsumerInterceptor<String, Object> {

  public ApiGatewayKafkaConsumerInterceptor(){
    System.out.println("$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$");
    System.out.println("$$$                                                   $$$");
    System.out.println("$$$         GATEWAY INTERCEPTOR REGISTERED            $$$");
    System.out.println("$$$                                                   $$$");
    System.out.println("$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$");
  }

  @Override
  public ConsumerRecords<String, Object> onConsume(ConsumerRecords<String, Object> consumerRecords) {
    return consumerRecords;
  }

  @Override
  public void onCommit(Map<TopicPartition, OffsetAndMetadata> offsets) {
  }

  @Override
  public void close() {
  }

  @Override
  public void configure(Map<String, ?> configs) {
  }

}

Kafka消费者配置类代码

package com.demo.api.gateway.kafka.config;

import com.demo.api.gateway.controller.switcher.TransactionController;
import com.demo.api.gateway.kafka.interceptor.ApiGatewayKafkaConsumerInterceptor;
import com.demo.api.gateway.kafka.model.ConsumerConfigType;
import com.demo.api.gateway.kafka.model.KafkaConsumerProperties;
import com.demo.common.kafka.interceptor.KafkaConsumerInterceptor;
import com.demo.common.service.ServiceLogger;
import org.apache.kafka.clients.consumer.ConsumerConfig;
import org.apache.kafka.common.serialization.StringDeserializer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
import org.springframework.context.annotation.Scope;
import org.springframework.kafka.annotation.EnableKafka;
import org.springframework.kafka.config.ConcurrentKafkaListenerContainerFactory;
import org.springframework.kafka.core.ConsumerFactory;
import org.springframework.kafka.core.DefaultKafkaConsumerFactory;
import org.springframework.kafka.support.DefaultKafkaHeaderMapper;
import org.springframework.kafka.support.serializer.JsonDeserializer;
import java.util.HashMap;
import java.util.Map;

@Configuration
@EnableKafka
public class KafkaConsumerConfig {

  private final ServiceLogger logger = new ServiceLogger(KafkaConsumerConfig.class);
  @Value("${kafka.concurrency}")
  int concurrency;
  @Autowired
  KafkaConsumerProperties kafkaProperties;

  //    @Value("${spring.kafka.consumer.session.timeout.ms}")
  //    private String sessionTimeout;
  @Bean
  public Map<String, Object> consumerConfigs() {
    return getProperties(ConsumerConfigType.DEFAULT);
  }

  private Map<String, Object> getProperties(ConsumerConfigType type) {
    System.out.print(kafkaProperties.getMaxPartitionFetchBytes());
    Map<String, Object> props = new HashMap<>();
    props.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, kafkaProperties.getBootStarpServers());
    props.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, kafkaProperties.isEnableAutoCommit());
    props.put(ConsumerConfig.AUTO_COMMIT_INTERVAL_MS_CONFIG, kafkaProperties.getAutoCommitIntervalMs());
    props.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, "15000");
    props.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
    props.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, JsonDeserializer.class);
    //props.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, false);
    props.put(ConsumerConfig.MAX_PARTITION_FETCH_BYTES_CONFIG, kafkaProperties.getMaxPartitionFetchBytes());
    props.put(ConsumerConfig.GROUP_ID_CONFIG, kafkaProperties.getGroupId(type)); //how or which group Id??
    props.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, kafkaProperties.getMaxPollRecords(type));
    props.put(ConsumerConfig.REQUEST_TIMEOUT_MS_CONFIG, kafkaProperties.getRequestTimeoutMS());
    props.put(JsonDeserializer.TRUSTED_PACKAGES, "*");
    System.out.println("Registering ApiGatewayKafkaConsumerInterceptor....");
    props.put(ConsumerConfig.INTERCEPTOR_CLASSES_CONFIG, ApiGatewayKafkaConsumerInterceptor.class.getName());
    return props;
  }

  @Bean(name = "consumerConfig")
  @Scope(value = "prototype")
  @Lazy(value = true)
  public Map<String, Object> consumerConfigs(ConsumerConfigType configType) {
    return getProperties(configType);
  }

  @ConditionalOnMissingBean(name = "requestKafkaListenerContainerFactory")
  public ConsumerFactory<String, Object> requestConsumerFactory() {
    Map<String, Object> props = consumerConfigs(ConsumerConfigType.REQUEST);
    System.out.println("Creating a consumer factory with props = " + props);
    return new DefaultKafkaConsumerFactory<>(props, new StringDeserializer(),
        new JsonDeserializer<>());
  }

  @Bean
  public ConcurrentKafkaListenerContainerFactory<String, Object> requestKafkaListenerContainerFactory() {
    ConcurrentKafkaListenerContainerFactory<String, Object> factory = new ConcurrentKafkaListenerContainerFactory<>();
    factory.setConsumerFactory(requestConsumerFactory());
    factory.setBatchListener(true);
    factory.setConcurrency(concurrency);
    return factory;
  }

  @Bean
  public DefaultKafkaHeaderMapper headerMapper() {
    return new DefaultKafkaHeaderMapper();
  }
}

问题现象

启动Spring Boot应用后，控制台打印出的消费者工厂属性中包含了interceptor.classes，但Kafka输出的ConsumerConfig值里该属性为空数组，拦截器的构造函数日志也未打印，说明拦截器未注册：

Registering ApiGatewayKafkaConsumerInterceptor....
Creating a consumer factory with props = {key.deserializer=class org.apache.kafka.common.serialization.StringDeserializer, spring.json.trusted.packages=*, value.deserializer=class org.springframework.kafka.support.serializer.JsonDeserializer, enable.auto.commit=true, max.poll.records=10, request.timeout.ms=60000, group.id=gateway-group, max.partition.fetch.bytes=100000000, bootstrap.servers=[127.0.0.1:9092], interceptor.classes=com.demo.api.gateway.kafka.interceptor.ApiGatewayKafkaConsumerInterceptor, auto.commit.interval.ms=1000, session.timeout.ms=15000}
2024-11-10 09:57:55.359  INFO 16024 --- [  restartedMain] o.a.k.clients.consumer.ConsumerConfig    : ConsumerConfig values: 
    allow.auto.create.topics = true
    auto.commit.interval.ms = 1000
    auto.offset.reset = latest
    bootstrap.servers = [127.0.0.1:9092]
    check.crcs = true
    client.dns.lookup = use_all_dns_ips
    client.id = consumer-gateway-group-1
    client.rack = 
    connections.max.idle.ms = 540000
    default.api.timeout.ms = 60000
    enable.auto.commit = true
    exclude.internal.topics = true
    fetch.max.bytes = 52428800
    fetch.max.wait.ms = 500
    fetch.min.bytes = 1
    group.id = gateway-group
    group.instance.id = null
    heartbeat.interval.ms = 3000
    interceptor.classes = []
    internal.leave.group.on.close = true
    internal.throw.on.fetch.stable.offset.unsupported = false
    isolation.level = read_uncommitted
    key.deserializer = class org.apache.kafka.common.serialization.StringDeserializer
    max.partition.fetch.bytes = 1048576
    max.poll.interval.ms = 300000
    max.poll.records = 10
    metadata.max.age.ms = 300000
    metric.reporters = []
    metrics.num.samples = 2
    metrics.recording.level = INFO
    metrics.sample.window.ms = 30000
    partition.assignment.strategy = [class org.apache.kafka.clients.consumer.RangeAssignor]
    receive.buffer.bytes = 65536
    reconnect.backoff.max.ms = 1000
    reconnect.backoff.ms = 50
    request.timeout.ms = 30000
    retry.backoff.ms = 100
    sasl.client.callback.handler.class = null
    sasl.jaas.config = null
    sasl.kerberos.kinit.cmd = /usr/bin/kinit
    sasl.kerberos.min.time.before.relogin = 60000
    sasl.kerberos.service.name = null
    sasl.kerberos.ticket.renew.jitter = 0.05
    sasl.kerberos.ticket.renew.window.factor = 0.8
    sasl.login.callback.handler.class = null
    sasl.login.class = null
    sasl.login.refresh.buffer.seconds = 300
    sasl.login.refresh.min.period.seconds = 60
    sasl.login.refresh.window.factor = 0.8
    sasl.login.refresh.window.jitter = 0.05
    sasl.mechanism = GSSAPI
    security.protocol = PLAINTEXT
    security.providers = null
    send.buffer.bytes = 131072
    session.timeout.ms = 10000
    socket.connection.setup.timeout.max.ms = 30000
    socket.connection.setup.timeout.ms = 10000
    ssl.cipher.suites = null
    ssl.enabled.protocols = [TLSv1.2]
    ssl.endpoint.identification.algorithm = https
    ssl.engine.factory.class = null
    ssl.key.password = null
    ssl.keymanager.algorithm = SunX509
    ssl.keystore.certificate.chain = null
    ssl.keystore.key = null
    ssl.keystore.location = null
    ssl.keystore.password = null
    ssl.keystore.type = JKS
    ssl.protocol = TLSv1.2
    ssl.provider = null
    ssl.secure.random.implementation = null
    ssl.trustmanager.algorithm = PKIX
    ssl.truststore.certificates = null
    ssl.truststore.location = null
    ssl.truststore.password = null
    ssl.truststore.type = JKS
    value.deserializer = class org.apache.kafka.common.serialization.StringDeserializer

进一步发现

我注意到不止拦截器属性被忽略，其他自定义配置也被覆盖了：比如我设置的session.timeout.ms=15000，但Kafka输出的ConsumerConfig里该值是10000；还有max.partition.fetch.bytes我设的是100000000，但Kafka显示的是默认值1048576。这说明问题不是拦截器单独的问题，而是我的自定义ConsumerConfig整体被Kafka覆盖了。

补充说明

我的微服务中没有使用@KafkaListener注解的方法，计划在调用kafkaTemplate.sendAndReceive()方法的接收环节使用这个拦截器。

请问如何让Kafka使用我自定义的ConsumerConfig，不再覆盖我的配置，同时让拦截器正常注册？

备注：内容来源于stack exchange，提问作者Abdulwahab Almestekawy

Spring Boot应用中Kafka消费者拦截器未注册且自定义ConsumerConfig被覆盖的问题求助

问题背景 #

拦截器代码 #

Kafka消费者配置类代码 #

问题现象 #

进一步发现 #

补充说明 #

问题背景

拦截器代码

Kafka消费者配置类代码

问题现象

进一步发现

补充说明