本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从 KCL 1.x 迁移到 KCL 3.x
<a name="kcl-migration-1-3"></a>

本主题说明如何将消费端从 KCL 1.x 迁移至 KCL 3.x。与 KCL 2.x 和 KCL 3.x 相比，KCL 1.x 使用不同的类和接口。必须先将记录处理器、记录处理器工厂和工作线程类迁移到 KCL 2.x/3.x 兼容格式，然后按照将 KCL 2.x 迁移到 KCL 3.x 的迁移步骤进行操作。可直接从 KCL 1.x 升级至 KCL 3.x。
+ **步骤 1：迁移记录处理器**

  按照[将消费端从 KCL 1.x 迁移至 KCL 2.x](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 页面中的[迁移记录处理器](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration)部分进行操作。
+ **步骤 2：迁移记录处理器工厂**

  按照[将消费端从 KCL 1.x 迁移至 KCL 2.x](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 页面中的[迁移记录处理器工厂](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-factory-migration)部分进行操作。
+ **步骤 3：迁移工作人员**

  按照[将消费端从 KCL 1.x 迁移至 KCL 2.x](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 页面中的[迁移工作程序](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#worker-migration)部分进行操作。
+ **第 4 步：迁移 KCL 1.x 配置**

  按照[将消费端从 KCL 1.x 迁移至KCL 2.x](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 页面中的[配置 Amazon Kinesis 客户端](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#client-configuration)部分进行操作。
+ **第 5 步：检查闲置时间删除和客户端配置移除情况**

  按照[将消费端从 KCL 1.x 迁移至 KCL 2.x](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 页面中的[闲置时间删除](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#idle-time-removal)和[客户端配置移除](https://docs.amazonaws.cn/streams/latest/dev/kcl-migration.html#client-configuration-removals)部分进行操作。
+ **第 6 步：按照 KCL 2.x 到 KCL 3.x 迁移 step-by-step指南中的说明进行操作**

  遵循 [从 KCL 2.x 迁移至 KCL 3.x](kcl-migration-from-2-3.md) 页面上的说明完成迁移。如需回滚到之前 KCL 版本，或在回滚后向前滚到 KCL 3.x，请参阅[回滚至先前 KCL 版本](kcl-migration-rollback.md)和[回滚后前滚到 KCL 3.x](kcl-migration-rollforward.md)。

**重要**  
不要在 KCL 3.x 中使用 2.27.19 到 2.27.23 适用于 Java 的 Amazon SDK 版本。这些版本出现的问题会导致使用 KCL 的 DynamoDB 时出现相关异常错误。我们建议您使用 2.28.0 或更高 适用于 Java 的 Amazon SDK 版本来避免此问题。