spring boot 的全局异常处理机制无法直接捕获生产者发送消息时产生的异常,因为全局异常处理器(如 @controlleradvice)仅作用于当前 web 请求的线程上下文。要捕获生产者发送异常,必须在调用 kafkatemplate.send() 的代码处使用 try-catch 块进行显式捕获,或者配置 kafkatemplate 的 errorhandler 来处理异步回调中的错误。

同步发送时如何捕获异常
在同步发送模式下,KafkaTemplate.send() 方法会阻塞直到收到 Broker 的响应或发生超时。如果在此过程中出现网络故障、序列化错误或 Broker 拒绝接收,该方法会抛出 org.springframework.kafka.core.KafkaException 或其子类异常。开发者需要在业务代码中直接包裹 try-catch 语句来捕获这些异常,并根据需要进行重试或记录日志。

import org.apache.kafka.clients.producer.ProducerRecord;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.kafka.core.KafkaTemplate;
import org.springframework.stereotype.Service;
@Service
public class ProducerService {
@Autowired
private KafkaTemplate<string string> kafkaTemplate;
public void sendMessage(String topic, String key, String value) {
try {
// 同步发送,阻塞等待结果
kafkaTemplate.send(topic, key, value).get();
System.out.println("Message sent successfully");
} catch (Exception e) {
// 捕获发送过程中的异常,包括网络、序列化、Broker拒绝等
System.err.println("Failed to send message: " + e.getMessage());
// 这里可以执行重试逻辑或告警
}
}
}</string>
上述代码展示了最基础的同步发送异常捕获方式。当 kafkaTemplate.send() 被调用时,它返回一个 ListenableFuture。如果在发送过程中发生异常,.get() 调用会抛出 ExecutionException,其内部原因通常是 KafkaException。通过捕获这个异常块,程序可以防止因消息发送失败而导致整个业务事务崩溃,同时允许开发者根据具体错误类型采取不同的恢复策略。
异步发送时如何配置错误处理
在异步发送模式下,KafkaTemplate.send() 立即返回 ListenableFuture,不会阻塞主线程。此时,发送过程中的异常不会直接抛出到业务代码中,而是需要通过配置 ProducerListener 或 ErrorHandler 来处理。推荐使用 KafkaTemplate 的 setProducerListener 方法设置自定义监听器,或者在 KafkaTemplate 初始化时配置 errorHandler。这样可以在消息发送成功、失败或无响应时分别执行不同的逻辑。

import org.apache.kafka.clients.producer.ProducerRecord;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.kafka.core.KafkaTemplate;
import org.springframework.kafka.listener.ContainerProperties.AckMode;
import org.springframework.stereotype.Service;
@Service
public class AsyncProducerService {
@Autowired
private KafkaTemplate<string string> kafkaTemplate;
public AsyncProducerService(KafkaTemplate<string string> kafkaTemplate) {
this.kafkaTemplate = kafkaTemplate;
// 配置异步发送的错误处理器
this.kafkaTemplate.setProducerListener(new CustomProducerListener());
}
public void asyncSendMessage(String topic, String key, String value) {
ListenableFuture<sendresult string>> future = kafkaTemplate.send(topic, key, value);
// 可以添加回调,但异常主要通过 Listener 处理
future.addCallback(
result -> System.out.println("Sent with offset: " + result.getRecordMetadata().offset()),
error -> System.err.println("Async send failed: " + error.getMessage())
);
}
}
class CustomProducerListener implements ProducerListener<string string> {
@Override
public void onSuccess(ProducerRecord<string string> record, SendResult<string string> result) {
System.out.println("Message sent successfully via listener");
}
@Override
public void onError(ProducerRecord<string string> record, Exception exception) {
System.err.println("Message failed via listener: " + exception.getMessage());
}
@Override
public void onSendError(ProducerRecord<string string> record, Exception exception) {
System.err.println("Send error occurred: " + exception.getMessage());
}
}</string></string></string></string></string></sendresult></string></string>
在异步场景中,CustomProducerListener 实现了 ProducerListener 接口,并重写了 onSuccess、onError 和 onSendError 方法。当消息发送成功时,onSuccess 被调用;当发送过程中发生异常时,onError 或 onSendError 被调用。这种方式解耦了业务逻辑与错误处理逻辑,使得异步发送更加健壮。需要注意的是,onError 和 onSendError 的区别在于触发时机,前者通常在消息已发送到 Broker 但未被确认时触发,后者在发送前或发送过程中立即失败时触发。
如何处理序列化异常导致的发送失败
当生产者尝试发送的消息对象无法被序列化为字节数组时,会抛出 SerializationException。这通常发生在消息体包含非标准数据类型或未正确配置 KeySerializer 和 ValueSerializer 的情况下。在这种情况下,即使使用了 try-catch 或 ProducerListener,也需要确保序列化器能够正确处理所有可能的输入类型。可以通过自定义序列化器或在发送前对消息进行预处理来解决此问题。











