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

# 如何解决依赖冲突？
<a name="ts-faq-dep-conflict-resolution"></a>

使用时 适用于 Kotlin 的 AWS SDK，它需要某些依赖项 AWS 和第三方依赖关系才能正常工作。如果缺少这些依赖项或在运行时出现意外版本，则可能会看到类似`NoSuchMethodError`或的错误`NoClassDefFoundError`。这些依赖问题通常分为两组：
+ SDK/Smithy 依赖冲突
+ 第三方依赖冲突

当你构建 Kotlin 应用程序时，你很可能会使用 Gradle 来管理依赖关系。在项目中添加对 SDK 服务客户端的依赖关系会自动包含所有必要的相关依赖项。但是，如果您的应用程序有其他依赖项，则它们可能会与 SDK 所需的依赖项发生冲突。例如，SDK 依赖 OkHttp于一个流行的 HTTP 客户端，您的应用程序也可能使用该客户端。为了帮助您发现这些冲突，Gradle 提供了一个方便的任务，它列出了项目的依赖关系：

```
./gradlew dependencies
```

遇到依赖关系冲突时，可能需要采取措施。您可以将依赖关系的特定版本或影子依赖项指定到本地命名空间。Gradle 依赖关系解析是一个复杂的主题，将在 *Gradle 用户手*册的以下章节中讨论：
+ [了解依赖关系解析](https://docs.gradle.org/current/userguide/dependency_resolution.html)
+ [依赖约束和冲突解决方案](https://docs.gradle.org/current/userguide/dependency_constraints_conflicts.html)
+ [对齐依赖项版本](https://docs.gradle.org/current/userguide/dependency_version_alignment.html)

## 在你的项目中管理 SDK 和 Smithy 依赖关系
<a name="sdk-smithy-dep-conflicts"></a>

使用 SDK 时，请记住，其模块通常依赖于版本号匹配的其他 SDK 模块。例如，`aws.sdk.kotlin:s3:1.2.3`依赖于 a`ws.sdk.kotlin:aws-http:1.2.3`，后者依赖于`aws.sdk.kotlin:aws-core:1.2.3`，依此类推。

SDK 模块还使用特定的 Smithy 模块版本。虽然 Smithy 模块版本与 SDK 版本号不同步，但它们必须与 SDK 的预期版本相匹配。例如，`aws.sdk.kotlin:s3:1.2.3`可能依赖于`aws.smithy.kotlin:serde:1.1.1`，哪个取决于`aws.smithy.kotlin:runtime-core:1.1.1`，依此类推。

为避免依赖冲突，请同时升级所有 SDK 依赖项，并对任何明确的 Smithy 依赖项执行相同的操作。考虑使用我们的 [Gradle 版本目录](setup-create-project-file.md)来保持版本同步，并消除在 SDK 和 Smithy 版本之间映射时的猜测。

请记住， SDK/Smithy 模块中的次要版本更新可能包括重大更改，如我们的[版本控制政策](https://github.com/awslabs/aws-sdk-kotlin/blob/main/VERSIONING.md#versioning-policy)所述。在次要版本之间升级时，请仔细查看变更日志并彻底测试运行时行为。

## 解决应用程序中的 OkHttp 版本冲突
<a name="okhttp-dep-conflicts"></a>

[OkHttp](https://square.github.io/okhttp/)是一款流行的 HTTP 引擎，SDK 默认在 JVM 上使用该引擎。您的应用程序可能包含其他引入不同 OkHttp 版本的依赖项或框架。这可能会导致`okhttp3`命名空间中的类变为，例如`okhttp/coroutines/ExecuteAsyncKt`或`okhttp3/ConnectionListener`。`NoClassDefFoundError`发生这种情况时，通常应选择较新的版本来解决冲突。为了帮助您追踪这些冲突的根源，Gradle 提供了一项有用的任务。你可以通过运行以下命令列出所有依赖关系：

```
./gradlew dependencies
```

例如，如果 SDK 依赖 OkHttp `5.0.0-alpha.14`于其他依赖项（例如 Spring Boot）， OkHttp `4.12.0`则应使用`5.0.0-alpha.14 version`。你可以在 Gradle 中使用一个`constraints`方块来做到这一点：

```
dependencies {
    constraints {
        implementation("com.squareup.okhttp3:okhttp:4.12.0")
    }
}
```

或者，如果您必须使用 OkHttp 4.x，SDK 会提供。`OkHttp4Engine`有关如何配置 Gradle 并在代码`OkHttp4Engine`中使用的信息，请参阅[文档](https://github.com/smithy-lang/smithy-kotlin/tree/main/runtime/protocol/http-client-engines/http-client-engine-okhttp4)。