１、KafkaConsumer poll 详解
消息拉起主要入口为：KafkaConsumer#poll方法，其声明如下：
1 | public ConsumerRecords<K, V> poll(final Duration timeout) { // @1 |
代码＠１：参数为超时时间，使用 java 的 Duration 来定义。
代码＠２：调用内部的 poll 方法。
KafkaConsumer#poll
1 | private ConsumerRecords<K, V> poll(final Timer timer, final boolean includeMetadataInTimeout) { // @1 |
代码＠１：首先先对其参数含义进行讲解。
- boolean includeMetadataInTimeout
拉取消息的超时时间是否包含更新元数据的时间，默认为true，即包含。
代码＠２：检查是否可以拉取消息，其主要判断依据如下：
- KafkaConsumer 是否有其他线程再执行，如果有，则抛出异常，因为 - KafkaConsumer 是线程不安全的，同一时间只能一个线程执行。
- KafkaConsumer 没有被关闭。
代码＠３：如果当前消费者未订阅任何主题或者没有指定队列，则抛出错误，结束本次消息拉取。
代码＠４：使用 do while 结构循环拉取消息，直到超时或拉取到消息。
代码＠５：避免在禁止禁用wakeup时，有请求想唤醒时则抛出异常，例如在下面的@8时，会禁用wakeup。
代码＠６：更新相关元数据，为真正向 broker 发送消息拉取请求做好准备，该方法将在下面详细介绍，现在先简单介绍其核心实现点：
- 如有必要，先向 broker 端拉取最新的订阅信息(包含消费组内的在线的消费客户端)。
- 执行已完成(异步提交)的 offset 提交请求的回调函数。
- 维护与 broker 端的心跳请求，确保不会被“踢出”消费组。
- 更新元信息。
- 如果是自动提交消费偏移量，则自动提交偏移量。
- 更新各个分区下次待拉取的偏移量。
这里会有一个更新元数据是否占用消息拉取的超时时间，默认为 true。
代码＠７：调用 pollForFetches 向broker拉取消息，该方法将在下文详细介绍。
代码＠８：如果拉取到的消息集合不为空，再返回该批消息之前，如果还有挤压的拉取请求，可以继续发送拉取请求，但此时会禁用warkup，主要的目的是用户在处理消息时，KafkaConsumer 还可以继续向broker 拉取消息。
代码＠９：执行消费拦截器。
接下来对上文提到的代码＠６、＠７进行详细介绍。
1.1 KafkaConsumer updateAssignmentMetadataIfNeeded 详解
KafkaConsumer＃updateAssignmentMetadataIfNeeded
1 | boolean updateAssignmentMetadataIfNeeded(final Timer timer) { |
要理解这个方法实现的用途，我们就必须依次对 coordinator.poll 方法与 updateFetchPositions 方法。
1.1.1 ConsumerCoordinator#poll
1 | public boolean poll(Timer timer) { |
代码＠1：执行已完成的 offset (消费进度)提交请求的回调函数。
代码@2：队列负载算法为自动分配（即 Kafka 根据消费者个数与分区书动态负载分区）的相关的处理逻辑。其实现关键点如下：
- 代码@21：更新发送心跳相关的时间，例如heartbeatTimer、sessionTimer、pollTimer 分别代表发送最新发送心跳的时间、会话最新活跃时间、最新拉取消息。
- 代码@22：如果不存在协调器或协调器已断开连接，则返回 false，结束本次拉取。如果协调器就绪，则继续往下走。
- 代码@23：判断是否需要触发重平衡，即消费组内的所有消费者重新分配topic中的分区信息，例如元数据发送变化，判断是否需要重新重平衡的关键点如下：
- 如果队列负载是通过用户指定的，则返回 false，表示无需重平衡。
- 如果队列是自动负载，topic 队列元数据发生了变化，则需要重平衡。
- 如果队列是自动负载，订阅关系发生了变化，则需要重平衡。
如果需要重重平衡，则同步更新元数据，此过程会阻塞。详细的重平衡将单独重点介绍，这里暂时不深入展开。
代码@3：用户手动为消费组指定负载的队列的相关处理逻辑，其实现关键如下：
- 如果需要更新元数据，并且还没有分区准备好，则同步阻塞等待元数据更新完毕。
代码@4：如果开启了自动提交消费进度，并且已到下一次提交时间，则提交。Kafka 消费者可以通过设置属性 enable.auto.commit 来开启自动提交，该参数默认为 true，则默认会每隔 5s 提交一次消费进度，提交间隔可以通过参数 auto.commit.interval.ms 设置。
接下来继续探讨 updateAssignmentMetadataIfNeeded (更新元数据)的第二个步骤，更新拉取位移。
1.1.2 updateFetchPositions 详解
KafkaConsumer#updateFetchPositions
1 | private boolean updateFetchPositions(final Timer timer) { |
代码@1：如果订阅关系中的所有分区都有有效的位移，则返回 true。
代码@2：如果存在任意一个分区没有有效的位移信息，则需要向 broker 发送请求，从broker 获取该消费组，该分区的消费进度。相关的实现细节将在后续文章【Kafka 消费进度】专题文章中详细介绍。
代码@3：如果经过第二步，订阅关系中还某些分区还是没有获取到有效的偏移量，则使用偏移量重置策略进行重置，如果未配置，则抛出异常。
代码@4：发送一个异步请求去重置那些正等待重置位置的分区。有关 Kafka 消费消费进度、重平衡等知识将会在后续文章中深入探讨，本文只需了解 poll 消息的核心处理流程。
从 KafkaConsumer#poll 中流程可以看到，通过 updateAssignmentMetadataIfNeeded 对元数据、重平衡，更新拉取偏移量等工作处理完成后，下一步就是需要向 broker 拉取消息了，其实现入口为：KafkaConsumer 的 pollForFetches 方法。
1.2 消息拉取
KafkaConsumer#pollForFetches
1 | private Map<TopicPartition, List<ConsumerRecord<K, V>>> pollForFetches(Timer timer) { |
代码@1：计算本次拉取的超时时间，其计算逻辑如下：
- 如果协调器为空，则返回当前定时器剩余时间即可。
- 如果协调器不为空，其逻辑较为复杂，为下面返回的超时间与当前定时器剩余时间相比取最小值。
- 如果不开启自动提交位移并且未加入消费组，则超时时间为Long.MAX_VALUE。
- 如果不开启自动提交位移并且已加入消费组，则返回距离下一次发送心跳包还剩多少时间。
- 如果开启自动提交位移，则返回 距离下一次自动提交位移所需时间 与 距离下一次发送心跳包所需时间 之间的最小值。
代码@2：如果数据已经拉回到本地，直接返回数据。将在下文详细介绍 Fetcher 的 fetchedRecords 方法。
代码@3:组装发送请求，并将存储在待发送请求列表中。
代码@4：如果已缓存的分区信息中存在某些分区缺少偏移量，如果拉取的超时时间大于失败重试需要阻塞的时间，则更新此次拉取的超时时间为失败重试需要的间隔时间，主要的目的是不希望在 poll 过程中被阻塞【后续会详细介绍 Kafka 拉取消息的线程模型，再来回顾一下这里】。
代码@5：通过调用NetworkClient 的 poll 方法发起消息拉取操作（触发网络读写）。
代码@6：更新本次拉取的时间。
代码@7：检查是需要重平衡。
代码@8：将从 broker 读取到的数据返回（即封装成消息）。
从上面消息拉取流程来看，有几个比较重要的方法，例如 Fetcher 类相关的方法，NetworkClient 的 poll 方法，那我们接下来来重点探讨。
我们先用一张流程图总结一下消息拉取的全过程：
接下来我们将重点看一下 KafkaConsumer 的 pollForFetches 详细过程，也就是需要详细探究 Fetcher 类的实现细节。
2、Fetcher 类详解
Fetcher 封装消息拉取的方法，可以看成是消息拉取的门面类。
2.1 类图
我们首先一一介绍一下 Fetcher 的核心属性与核心方法。
- ConsumerNetworkClient client
消费端网络客户端，Kafka 负责网络通讯实现类。 - int minBytes
一次消息拉取需要拉取的最小字节数，如果不组，会阻塞，默认值为1字节，如果增大这个值会增大吞吐，但会增加延迟，可以通参数 fetch.min.bytes 改变其默认值。 - int maxBytes
一次消息拉取允许拉取的最大字节数，但这不是绝对的，如果一个分区的第一批记录超过了该值，也会返回。默认为50M,可通过参数 fetch.max.bytes 改变其默认值。同时不能超过 broker的配置参数(message.max.bytes) 和 主题级别的配置(max.message.bytes)。 - int maxWaitMs
在 broker 如果符合拉取条件的数据小于 minBytes 时阻塞的时间，默认为 500ms ，可通属性 fetch.max.wait.ms 进行定制。 - int fetchSize
每一个分区返回的最大消息字节数，如果分区中的第一批消息大于 fetchSize 也会返回。 - long retryBackoffMs
失败重试后需要阻塞的时间，默认为 100 ms，可通过参数 retry.backoff.ms 定制。 - long requestTimeoutMs
客户端向 broker 发送请求最大的超时时间，默认为 30s，可以通过 request.timeout.ms 参数定制。 - int maxPollRecords
单次拉取返回的最大记录数，默认值 500，可通过参数 max.poll.records 进行定制。 - boolean checkCrcs
是否检查消息的 crcs 校验和，默认为 true，可通过参数 check.crcs 进行定制。 - Metadata metadata
元数据。 - FetchManagerMetrics sensors
消息拉取的统计服务类。 - SubscriptionState subscriptions
订阅信息状态。 - ConcurrentLinkedQueue< CompletedFetch> completedFetches
已完成的 Fetch 的请求结果，待消费端从中取出数据。 - Deserializer< K> keyDeserializer
key 的反序列化器。 - Deserializer< V> valueDeserializer
value 的饭序列化器。 - IsolationLevel isolationLevel
Kafka的隔离级别（与事务消息相关），后续在研究其事务相关时再进行探讨。 - Map<Integer, FetchSessionHandler> sessionHandlers
拉取会话监听器。
接下来我们将按照消息流程，一起来看一下 Fetcher 的核心方法。
2.2 Fetcher 核心方法
2.2.1 Fetcher#fetchedRecords
Fetcher#fetchedRecords
1 | public Map<TopicPartition, List<ConsumerRecord<K, V>>> fetchedRecords() { |
代码@1：首先先解释两个局部变量的含义：
- Map<TopicPartition, List<ConsumerRecord<K, V>>> fetched 按分区存放已拉取的消息，返回给客户端进行处理。
- recordsRemaining：剩余可拉取的消息条数。
代码@2：循环去取已经完成了 Fetch 请求的消息，该 while 循环有两个跳出条件：
- 如果拉取的消息已经达到一次拉取的最大消息条数，则跳出循环。
- 缓存中所有拉取结果已处理。
代码@3、@4 主要完成从缓存中解析数据的两个步骤，初次运行的时候，会进入分支@3，然后从 调用 parseCompletedFetch 解析成 PartitionRecords 对象，然后代码@4的职责就是从解析 PartitionRecords ，将消息封装成 ConsumerRecord，返回给消费端线程处理。
代码@3的实现要点如下：
- 首先从 completedFetches (Fetch请求的返回结果) 列表中获取一个 Fetcher 请求，主要使用的 Queue 的 peek()方法，并不会从该队列中移除该元素。
- 然后调用 parseCompletedFetch 对处理结果进行解析返回 PartitionRecords。
- 处理成功后，调用 Queue 的方法将已处理过的 Fetcher结果移除。
从上面可知，上述方法的核心方法是：parseCompletedFetch。
代码@4的实现要点无非就是调用 fetchRecords 方法，按分区组装成 Map<TopicPartition, List<ConsumerRecord<K, V>>>，供消费者处理，例如供业务处理。
接下来将重点探讨上述两个方法的实现细节。
2.2.1.1 Fetcher#parseCompletedFetch
在尝试探讨该方法之前，我们首先对其入参进行一个梳理，特别是先认识其主要数据结构。
1、CompletedFetch 相关类图
从上图可以看出，CompleteFetch 核心属性主要如下：
- TopicPartition partition
分区信息，返回结果都是以分区为纬度。 - long fetchedOffset
本次拉取的开始偏移量。 - FetchResponse.PartitionData partitionData
返回的分区数据。 - FetchResponseMetricAgregator metricAggregator
统计指标相关。 - short responseVersion
broker 端的版本号。
分区的数据是使用 PartitionData 来进行封装的。我们也来简单的了解一下其内部数据结果。
- Errors error
分区拉取的相应结果，Errors.NONE 表示请求成功。 - long highWatermark
broker 端关于该分区的高水位线，即小于该偏移量的消息对于消费端是可见的。 - long lastStableOffset
分区中小于该偏移量的消息的事务状态已得到确认，要么是已提交，要么是已回滚，与事务相关，后面会专门探讨。 - List< AbortedTransaction> abortedTransactions
已拒绝的事物。 - T records
分区数据，是 BaseRecords 的子类。
2、parseCompletedFetch 详解
1 | private PartitionRecords parseCompletedFetch(CompletedFetch completedFetch) { |
上面的代码虽然比较长，其实整体还是比较简单，只是需要针对各种异常处理，打印对应的日志，接下来详细介绍该方法的实现关键点。
代码@1：判断该分区是否可拉取，如果不可拉取，则忽略这批拉取的消息，判断是可拉取的要点如下：
- 当前消费者负载的队列包含该分区。
- 当前消费者针对该队列并没有被用户设置为暂停（消费端限流）。
- 当前消费者针对该队列有有效的拉取偏移量。
代码@2：该分支是处理正常返回的相关逻辑。其关键点如下：
- 如果当前针对该队列的消费位移 与 发起 fetch 请求时的 偏移量不一致，则认为本次拉取非法，直接返回 null ，如代码@21。
- 从返回结构中获取本次拉取的数据，使用数据迭代器，其基本数据单位为 RecordBatch，即一个发送批次，如代码@22。
- 如果返回结果中没有包含至少一个批次的消息，但是 sizeInBytes 又大于0，则直接抛出错误，根据服务端的版本，其错误信息有所不同，但主要是建议我们如何处理，如果 broker 的版本低于 0.10.1.0，则建议升级 broker 版本，或增大客户端的 fetch size，这种错误是因为一个批次的消息已经超过了本次拉取允许的最大拉取消息大小，如代码@23。
- 依次更新消费者本地关于该队列的订阅缓存信息的 highWatermark、logStartOffset、lastStableOffset。
从代码@3到@8 是多种异常信息的处理。
代码@3：如果出现如下3种错误码，则使用 debug 打印错误日志，并且向服务端请求元数据并更新本地缓存。
- NOT_LEADER_FOR_PARTITION
请求的节点上不是该分区的 Leader 分区。 - REPLICA_NOT_AVAILABLE
该分区副本之间无法复制 - KAFKA_STORAGE_ERROR
存储异常。
Kafka 认为上述错误是可恢复的，而且对消费不会造成太大影响，故只是用 debug 打印日志，然后更新本地缓存即可。
代码@4：如果出现 UNKNOWN_TOPIC_OR_PARTITION 未知主题与分区时，则使用 warn 级别输出错误日志，并更新元数据。
代码@5：针对 OFFSET_OUT_OF_RANGE 偏移量超过范围异常的处理逻辑，其实现关键点如下：
- 如果此次拉取的开始偏移量与消费者本地缓存的偏移量不一致，则丢弃，说明该消息已过期，打印错误日志。
- 如果此次拉取的开始偏移量与消费者本地缓存的偏移量一致，说明此时的偏移量非法，如果有配置重置偏移量策略，则使用重置偏移量，否则抛出 OffsetOutOfRangeException 错误。
代码@6：如果是 TOPIC_AUTHORIZATION_FAILED 没有权限(ACL)则抛出异常。
代码@7：如果本次拉取的结果不是NONE(成功)，并且是可恢复的，将该队列的订阅关系移动到消费者缓存列表的末尾。如果成功，则返回拉取到的分区数据，其封装对象为 PartitionRecords。
接下来我们再来看看 2.1.1 fetchedRecords 中的另外一个核心方法。
2.2.1.2 fetchRecords()
在介绍该方法之前同样先来看一下参数 PartitionRecords 的内部结构。
1、PartitionRecords 类图
主要的核心属性如下：
- TopicPartition partition
分区信息。 - CompletedFetch completedFetch
Fetch请求完成结果 - Iterator<? extends RecordBatch> batches
本次 Fetch 操作获取的结果集。 - Set< Long> abortedProducerIds
与事物相关，后续会专门的章节详细介绍。 - PriorityQueue<FetchResponse.AbortedTransaction> abortedTransactions
与事物相关，后续会专门的章节详细介绍。 - int recordsRead
已读取的记录条数。 - int bytesRead
已读取的记录字节数。 - RecordBatch currentBatch
当前遍历的批次。 - Record lastRecord
该迭代器最后一条消息。 - long nextFetchOffset
下次待拉取的偏移量。
2、fetchRecords 详解
1 | private List<ConsumerRecord<K, V>> fetchRecords(PartitionRecords partitionRecords, int maxRecords) { |
代码@1：从 PartitionRecords 中提取消息之前，再次判断订阅消息中是否包含当前分区，如果不包含，则使用 debug 打印日志，很有可能是发生了重平衡。
代码@2：是否允许拉取，如果用户主动暂停消费，则忽略本次拉取的消息。备注：Kafka 消费端如果消费太快，可以进行限流。
代码@3：从本地消费者缓存中获取该队列已消费的偏移量，在发送拉取消息时，就是从该偏移量开始拉取的。
代码@4：如果本地缓存已消费偏移量与从服务端拉回的起始偏移量相等的话，则认为是一个有效拉取，否则则认为是一个过期的拉取，该批消息已被消费，见代码@5。如果是一个有效请求，则使用 sensors 收集统计信息，并返回拉取到的消息， 返回结果被封装在 List<ConsumerRecord<K, V>> 。
2.2.2 sendFetches
“发送” fetch 请求，注意这里并不会触发网络操作，而是组装拉取请求，将其放入网络缓存区。
Fetcher#sendFetches
1 | public synchronized int sendFetches() { |
代码@1：首先通过调用 fetchablePartitions() 获取可发起拉取任务的分区信息，下文简单介绍一下。
代码@2：如果该分区在客户端本地缓存中获取该分区的 Leader 节点信息。
代码@3：如果其 Leader 节点信息为空，则发起更新元数据请求，本次拉取任务将不会包含该分区。
代码@4：如果客户端与该分区的 Leader 连接为完成，如果是因为权限的原因则抛出ACL相关异常，否则打印日志，本次拉取请求不会包含该分区。
代码@5：判断该节点是否有挂起的拉取请求，即发送缓存区中是待发送的请求,如果有，本次将不会被拉取。
代码@6：构建拉取请求，分节点组织请求。
2.2.2.2 NetworkClient send 方法关键点
NetworkClient 的 send 方法只是将其放入 unsent 中。
与上文的 client.hasPendingRequests(node) 方法遥相呼应。
3、总结
上面的源码分析有点长，也有点枯燥，我们还是画一张流程图来进行总结。
Kafka 的消息拉取流程还是比较复杂的，后面会基于上述流程，重点进行拆解，例如消费进度提交，负载队列重平衡等等。