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

使用 适用于 Java 的 AWS SDK 1.x 客户端查找应用程序

在迁移到之前 AWS SDK for Java 2.x，您需要确定您的环境中哪些应用程序使用 SDK for Java 1.x 客户端。您可以使用 CloudTrail 日志来跟踪 SDK 的使用情况，在应用程序日志中搜索弃用警告，检查源代码和编译配置，或者检查可部署的 Java 构件。使用环境中可用的任何方法。

使用 CloudWatch Logs Insights 查找具有 1.x 客户端的应用程序

Amazon L CloudWatch ogs Insights 允许您查询发送到 CloudWatch 日志日志组 CloudTrail 的事件。使用此方法从 CloudTrail 记录中的 UserAgent 字段中识别 SDK 版本。你需要一个启用了CloudWatch 日志的 CloudTrail 跟踪。如果没有，请参阅使用 CloudTrail 控制台创建跟踪和将事件发送到 CloudWatch 日志。

在 CloudWatch 控制台中，导航到 “日志” 下的 “日志见解”。选择您的 CloudTrail日志组，然后将时间范围设置为涵盖您要分析的时段。有关使用 Logs Insights 的详细信息，请参阅使用 Log s Insights 分析 CloudWatch 日志数据。

以下示例查询可查找用户应用程序和第三方工具通过 SDK for Java 1.x 发出的所有请求。日志见解支持 Logs Insights QL 和 SQL。QL 查询使用在控制台中选择的日志组。SQL 查询要求您在FROM子句中指定日志组名称。

日志见解 QL 查询：

fields userIdentity.type, userIdentity.arn, eventSource, awsRegion,
       eventName, eventType, eventTime, userAgent, sourceIPAddress
| filter userAgent like /aws-sdk-java\/1\./
| filter userAgent not like /aws-internal\//
| sort eventTime desc

SQL 查询：

SELECT `userIdentity.type`,
       `userIdentity.arn`,
       eventSource,
       awsRegion,
       eventName,
       eventType,
       eventTime,
       userAgent,
       sourceIPAddress
  FROM `sample-cloudtrail-log-group`
 WHERE userAgent LIKE '%aws-sdk-java/1.%'
   AND userAgent NOT LIKE '%aws-internal/%'
 ORDER BY eventTime DESC

sample-cloudtrail-log-group替换为您的 CloudTrail 日志组的名称。

要导出结果，请选择导出结果。以下示例显示了 JSON 格式的单个事件：

{
  "userIdentity.type": "AssumedRole",
  "userIdentity.arn": "arn:aws:sts::123456789012:assumed-role/Admin/Alice",
  "eventSource": "dynamodb.amazonaws.com",
  "awsRegion": "us-east-1",
  "eventName": "ListTables",
  "eventType": "AwsApiCall",
  "eventTime": "2025-07-01T22:02:23Z",
  "userAgent": "aws-sdk-java/1.12.746 Linux/5.10.240 OpenJDK/11.0.25+9-LTS ...",
  "sourceIPAddress": "12.345.6.78"
}

在此示例中，Dynamo ListTables DB 请求是从 IP 12.345.6.78 地址发出2025-07-01T22:02:23 (UTC)的，使用代入角色的凭证。Admin/AliceUserAgent 字段显示请求是在装有 JDK 11 的 Linux 系统1.12.746上使用适用于 Java 的 SDK 版本发出的。

有关 AWS CloudTrail 事件记录中各字段的描述，请参阅CloudTrail 记录内容。

CloudTrail 如果您的账户中未启用，请联系贵组织的 AWS 账户管理员将其启用，或者使用以下各节中描述的替代方法之一。

CloudWatch Logs Insights 根据扫描的数据量对每次查询收费。如果您专门为此调查创建了跟踪，请考虑将其停止或删除，以避免持续收费。有关当前定价，请参阅 Amazon CloudWatch 定价。

在应用程序警告级别的日志中搜索 SDK 的弃用

从 1.12.767 版本（2024 年 7 月 30 日发布）开始， 适用于 Java 的 AWS SDK 1.x 会在应用程序启动时发出弃用警告。您可以在应用程序日志中搜索此警告，以确定哪些应用程序和主机正在使用 SDK for Java 1.x。

警告的确切措辞取决于 SDK 版本：

尾部...表示警告消息继续显示其他文本。您可以搜索常用前缀The AWS SDK for Java 1.x来查找警告的任一版本。

以下示例演示如何使用以下方法搜索此警告grep：

grep -r "The AWS SDK for Java 1.x" /path/to/your/application/logs/

如果找到警告，该grep命令将打印匹配的日志行。如果未找到警告，则可能是您的应用程序未使用适用于 Java 1.x 的 SDK，或者它使用的是低于 1.12.767 的版本。在这种情况下，请使用本文档中描述的其他方法之一。

搜索源代码和依赖关系

您可以在代码库和构建配置文件中搜索对 适用于 Java 的 AWS SDK 1.x 的引用。密钥标识符是com.amazonaws群组 ID，所有 SDK for Java 1.x 工件都使用该标识。

以下示例演示了grep如何使用在常用 Java 项目文件中搜索com.amazonaws引用。

示例：在 Java 源文件中搜索适用于 Java 的 SDK 1.x 导入（从项目根目录运行）

grep -r "import com.amazonaws" --include="*.java" .

输出示例：

src/main/java/com/example/App.java:import com.amazonaws.services.s3.AmazonS3;

示例：在 Maven pom.xml 文件中搜索适用于 Java 的 SDK 1.x 依赖项（从项目根目录运行）

grep -r "com.amazonaws" --include="pom.xml" .

输出示例：

pom.xml:    <groupId>com.amazonaws</groupId>

示例：在 Gradle 构建文件中搜索 SDK for Java 1.x 依赖项（从项目根目录运行）

grep -r "com.amazonaws:aws-java-sdk" --include="*.gradle" .

输出示例：

build.gradle:    implementation 'com.amazonaws:aws-java-sdk-s3:1.12.xxx'

前面的grep命令标识了直接在源文件和编译文件中声明的 SDK for Java 1.x 引用。但是，您的应用程序也可能通过本身依赖于 SDK 的 SDK for Java 1.x，即通过本身依赖于 SDK 的第三方库。使用构建工具的依赖关系树查找适用于 Java 1.x 的 SDK 的直接依赖关系和传递依赖关系。选择与您的编译系统相匹配的示例。

示例：使用 Maven 查找所有适用于 Java 的 SDK 1.x 依赖项（从项目根目录运行）

mvn dependency:tree -Dincludes=com.amazonaws

输出示例：

[INFO] com.example:my-application:jar:1.0-SNAPSHOT
[INFO] +- com.amazonaws:aws-java-sdk-s3:jar:1.12.746:compile
[INFO] |  \- com.amazonaws:aws-java-sdk-core:jar:1.12.746:compile
[INFO] \- some.thirdparty:library:jar:2.3.1:compile
[INFO]    \- com.amazonaws:aws-java-sdk-dynamodb:jar:1.12.600:compile

该-Dincludes=com.amazonaws标志会筛选树以仅显示适用于 Java 的 SDK 1.x 构件。在此示例中，aws-java-sdk-s3是直接依赖关系，但aws-java-sdk-dynamodb它是由some.thirdparty:library引入的传递依赖关系。

示例：使用 Gradle 查找所有适用于 Java 的 SDK 1.x 依赖项（从项目根目录运行）

gradle dependencies --configuration runtimeClasspath | grep "com.amazonaws"

输出示例：

+--- com.amazonaws:aws-java-sdk-s3:1.12.746
|    \--- com.amazonaws:aws-java-sdk-core:1.12.746
\--- com.amazonaws:aws-java-sdk-dynamodb:1.12.600

Gradle 没有与 Maven 相当的内置依赖过滤器-Dincludes，因此管道传递grep是最简单的方法。

检查可部署的 Java 工件

您可以检查可部署的 Java 工件（JARs WARs、或 EARs），以确认 适用于 Java 的 AWS SDK 1.x 是否与您的应用程序打包在一起。Java 存档文件是 ZIP 格式的文件。要确定是否存在适用于 Java 的 SDK 1.x，请在存档com/amazonaws/sdk/versionInfo.properties中查找该文件。此文件包含在aws-java-sdk-core模块中，并包含 SDK 版本号。

使用jar命令快速检查

对于所有依赖类都在顶层合并的 uber-jar，请列出存档内容并搜索版本文件：

在以下示例中，myapp.jar替换为应用程序的 JAR 文件的路径。

jar -tf myapp.jar | grep 'versionInfo.properties'

如果有 SDK，则输出为：

com/amazonaws/sdk/versionInfo.properties

如果该jar命令在您的环境中不可用（例如，仅限 JRE 或最小容器镜像），则可以改用unzip -l：

unzip -l myapp.jar | grep 'versionInfo.properties'

要打印版本，请执行以下操作：

unzip -p myapp.jar com/amazonaws/sdk/versionInfo.properties

输出示例：

platform=java
version=1.12.xxx

使用 CloudTrail Lake 查找具有 1.x 客户端的应用程序

AWS CloudTrail Lake 允许您查询由记录的事件 CloudTrail。按照以下步骤来创建数据湖，用于识别应用程序使用的 SDK 版本：

每条记录中的 userAgent 字段包含发出请求的 SDK 版本。使用此字段来识别使用适用于 Java 的 SDK 1.x 的应用程序。

以下示例查询将查找从 2025 年 6 月 17 日起，用户应用程序和第三方工具使用 SDK for Java 1.x 发出的所有 EventDatastore ID sample-Data-Store-Id 请求：

select userIdentity, eventSource, awsRegion,
    eventName, eventType, eventTime, userAgent,
    requestParameters, sourceIPAddress
 from sample-Data-Store-Id
where eventTime > '2025-06-17 00:00:00'
and userAgent like '%aws-sdk-java/1.%'
and userAgent not like '%aws-internal/%'
order by eventTime desc

查询结果中的事件内容类似于以下示例：

{
    "userIdentity": "{
         "type": "IAMUser",
         "principalId": "AIDAJ45Q7YFFAREXAMPLE",
         "arn": "arn:aws:iam::123456789012:user/Alice",
         "accountId": "123456789012",
         "accessKeyId": "",
         "userName": "Alice"
    }",
    "eventSource": "dynamodb.amazonaws.com",
    "awsRegion": "us-west-2",
    "eventName": "ListTables",
    "eventType": "AwsApiCall",
    "eventTime": "2025-07-01 02:23:52.000",
    "userAgent": "aws-sdk-java/1.12.746 Linux/5.10.240 OpenJDK/11.0.25+9-LTS ...",
    "requestParameters": "",
    "sourceIPAddress": "12.345.6.78"
}

您可以使用此信息来帮助确定何时何地发出请求。

在示例中，使用名为 Alice 的 IAM 用户的凭证，在 2025-07-01 02:23:52 (UTC) 从 IP 地址 12.345.6.78 发出 DynamoDB ListTables 请求。userAgent 字段的值显示请求是使用装有 JDK 11 1.12.746 的 Linux 系统的 适用于 Java 的 AWS SDK 版本发出的。

有关 AWS CloudTrail 事件记录中各字段的描述，请参阅管理、数据和网络活动事件的CloudTrail 记录内容。

CloudTrail 如果您的账户中未启用，请联系贵组织的 AWS 账户管理员将其启用，或者使用前几节中描述的替代方法之一。

CloudTrail Lake 会对每次查询摄取的数据和扫描的数据收费。为了最大限度地降低成本，请将查询筛选到特定的时间范围和区域。有关当前定价，请参阅 AWS CloudTrail 定价。