AWS SDK for Java v2 2.29.x 版本发布全览核心引擎演进与 52 个版本的服务能力更新解读【免费下载链接】aws-sdk-java-v2The official AWS SDK for Java - Version 2项目地址: https://gitcode.com/GitHub_Trending/aw/aws-sdk-java-v2本指南基于当前仓库中的官方发布记录 changelogs/2.29.x-CHANGELOG.md系统梳理 AWS SDK for Java v2 在 2024 年 10 月 24 日至 2025 年 1 月 14 日期间发布的 2.29.0 ~ 2.29.52 共 52 个版本的完整变更。读完本文你将掌握该版本线中 SDK 核心引擎JSON 协议解析、重试策略、校验和、SigV4、IMDS 超时配置、用户代理等的底层演进细节逐一了解各 AWS 服务GameLift、Route 53、Bedrock 系列、DynamoDB、S3、ECS、EC2 等的新增 API 与行为变更并借助仓库源码定位关键改动的实现位置为升级与排障提供直接依据。一、版本线总览52 个版本的节奏与构成2.29.x 是 AWS SDK for Java v2 的一个长期维护版本线横跨 2024 年第四季度至 2025 年 1 月中旬。该版本线表现出几个鲜明特征高频发布从 2.29.02024-10-24到 2.29.522025-01-14平均每个工作日都有版本产出其中 2024-12-04 一天内发布了 2.29.28 与 2.29.29 两个版本三类变更并存每版均包含Features新功能、Bugfixes缺陷修复个别版本还包含Deprecations弃用声明并以AWS SDK for Java v2条目区分SDK 核心改动与服务能力更新端点元数据常态化更新绝大多数版本都包含 Updated endpoint and partition metadata这是 SDK 随服务端全局基础设施变化新增区域、分区端点调整自动同步的结果例如 Route 53 在 2.29.48 支持亚太泰国区域ap-southeast-7、在 2.29.52 支持墨西哥中部区域mx-central-1。版本命名与发布历史约定可参见 VERSIONING.md 与总览 CHANGELOG.md其余版本线的完整记录位于 changelogs 目录。二、SDK 核心引擎演进从解析、重试到校验和的底层优化2.29.x 对 SDK 运行时的改动集中在协议解析、HTTP 客户端行为、重试机制、签名、校验和与元数据服务配置等方向。这些改动全部标注为AWS SDK for Java v2条目直接决定所有服务客户端的通用行为。2.1 默认启用 Java 内置 CRC32/CRC32C性能与 API 弃用同步落地2.29.02.29.0 是 2.29.x 的起点版本核心变更为SDK 默认改用 Java 内置的 CRC32 与 CRC32C 实现Java 9 环境下从而获得更好的性能同时弃用内部校验和算法类Deprecations。从仓库结构看校验和实现集中在 core/checksums 模块。这次变更的实质是在 Java 9 及以上版本中java.util.zip.CRC32C等 JDK 原生实现经过 JIT 优化后吞吐优于自研实现因此 SDK 将其作为默认路径同时保留自研实现用于兼容较旧 JDK 与特殊场景。用户通常无需任何配置即可受益因为默认值已切换只有显式引用内部校验和类的代码才需要关注弃用警告。2.2 JSON 协议边解析边解组统一反序列化性能2.29.72.29.7 对全部 JSON 协议core/protocols/aws-json-protocol 及其它协议模块做了一项重要的性能优化将解析parsing与解组unmarshalling合二为一而不是先完整解析再逐字段解组。这减少了中间对象的构造与遍历开销使所有基于 JSON 的服务客户端如 DynamoDB、Lambda、S3 的部分 API的反序列化延迟普遍受益。2.3 重试策略默认退避策略统一收敛到 Builder2.29.7同版本还修复了重试策略默认值设置位置不一致的问题此前只有DefaultRetryStrategy的 Builder 方法会设置默认退避策略现在所有重试策略 Builder 都统一按 javadoc 约定设置默认 backoff 策略。重试相关实现位于 core/retries 与 core/retries-spi。这意味着通过RetryPolicy自定义重试时即使不显式指定退避策略也会获得与 javadoc 一致的默认行为避免不同构造路径下行为漂移。2.4 默认重试谓词叠加在用户自定义谓词之上2.29.282.29.28 修复了一个容易踩坑的语义问题SDK 现在会在用户提供的重试谓词之上叠加默认重试谓词。此前若用户自定义了RetryCondition默认的限流/异常判定可能被完全覆盖此版本保证默认重试条件始终生效自定义谓词只做增量扩展。2.5 SigV4 只在缺失时补写 Host 头2.29.102.29.10 修复了签名行为SigV4 计算仅在请求未携带 Host 头时才补充该头避免重复/覆盖已有 Host 头导致的签名不一致。此项由社区贡献者 vsudilov。2.6 回滚所有 HTTP 方法携带请求体实体的变更2.29.262.29.26 做了一次谨慎的回滚撤销 PR #5704——该 PR 曾让所有 HTTP 方法包括 GET/DELETE 等都在请求中包含请求体实体因对部分服务造成回归问题而被整体回退。这说明 SDK 在 HTTP 语义上坚持按方法区分请求体的保守策略避免对服务端行为产生意外影响。2.7 Apache HTTP 客户端DELETE/GET/HEAD/OPTIONS 请求体处理修复2.29.222.29.22 修复了 http-clients/apache-client 中ApacheHttpClient 对 DELETE、GET、HEAD、OPTIONS 请求携带请求体的处理由社区贡献者 Xtansia 提交。此前这些方法在携带 body 时可能被错误处理导致请求发送失败或服务端解析异常修复后这些方法的请求体能够按预期发送。2.8 CRT 客户端GetObject 中途失败的错误上抛2.29.242.29.24 修复了AWS CRT-based S3 客户端http-clients/aws-crt-client 与 services/s3 的 CRT 模式中 GetObject 请求进行到一半失败时错误未被抛出的问题对应 issue #5631。修复后失败会正确暴露给调用方而不是静默丢失。2.9 新增AWS_METADATA_SERVICE_TIMEOUT统一配置 IMDS 连接与读取超时2.29.362.29.36 引入了一项面向 EC2 元数据服务IMDS的可配置能力新增环境变量AWS_METADATA_SERVICE_TIMEOUT、系统属性aws.ec2MetadataServiceTimeout以及配置文件属性metadata_service_timeout用于同时配置 InstanceProfileCredentialsProvider 与 IMDS 客户端的连接超时和读取超时单位秒。结合仓库源码可以确认其底层实现系统属性定义于 core/sdk-core/src/main/java/software/amazon/awssdk/core/SdkSystemSetting.javaAWS_METADATA_SERVICE_TIMEOUT(aws.ec2MetadataServiceTimeout, 1)默认值为 1 秒且该值同时作用于 socket connect 与 read 两个阶段配置文件属性定义于 core/profiles/src/main/java/software/amazon/awssdk/profiles/ProfileProperty.javaMETADATA_SERVICE_TIMEOUT metadata_service_timeout读取与解析逻辑位于 core/auth/src/main/java/software/amazon/awssdk/auth/credentials/internal/Ec2MetadataConfigProvider.java 与 core/imds/src/main/java/software/amazon/awssdk/imds/internal/Ec2MetadataConfigProvider.java对应测试见 core/auth/src/test/java/software/amazon/awssdk/auth/credentials/internal/Ec2MetadataServiceTimeoutResolverTest.java。配置优先级与环境变量、系统属性、配置文件三者一致。典型用法示例# 环境变量方式单位秒 export AWS_METADATA_SERVICE_TIMEOUT2# ~/.aws/config 配置文件方式 [default] metadata_service_timeout 2// 系统属性方式在启动参数或代码中设置 System.setProperty(aws.ec2MetadataServiceTimeout, 2);该配置对网络状况不佳的 EC2、EKS 等运行环境尤其重要调大超时值可降低元数据服务偶发延迟导致的凭据获取失败概率。2.10 用户代理业务指标段m/功能使用跟踪的新格式2.29.42.29.4 引入了在用户代理字符串中跟踪功能使用情况的新机制新增m/业务指标元数据段功能以 Base64 编码字符串表示此前用文本表示的旧格式如 DynamoDB Enhanced Client 记为hll/ddb-enh迁移到新格式如d。这属于 SDK 遥测/可观测性改进不影响功能行为但会改变请求头中的 User-Agent 内容。用户代理构造机制详见 docs/user-agent.md。2.11 事件流异常反序列化修复与 CRT 类加载方式调整2.29.5 / 2.29.62.29.5 修复了事件流eventstream异常无法正确反序列化为预期异常类型的问题2.29.6 将CRT Checksum 类的加载方式改为通过 ClassLoader 加载而非直接引用 CRT 类降低类加载器隔离环境如应用服务器、插件容器下的链接失败风险。三、重点服务能力更新按服务维度2.29.x 覆盖了 AWS 全线服务的 API 演进。以下是按服务聚类的高价值变更3.1 生成式 AI 服务Bedrock 家族成为更新最密集的板块Bedrock 相关服务Amazon Bedrock、Amazon Bedrock Runtime、Agents for Amazon Bedrock、Agents for Amazon Bedrock Runtime、Data Automation 及 Runtime在 2.29.x 中更新最为密集几乎贯穿整个版本线智能提示路由Intelligent Prompt Router2.29.28新增ListPromptRouters、GetPromptRouter两个 API并在Invoke、InvokeStream、Converse、ConverseStream中支持Guardrails 图像内容过滤2.29.28Bedrock Runtime 新增图像内容过滤能力Bedrock Marketplace2.29.28支持自托管模型的更大范围兼容异步调用Async Invoke2.29.26新增Start、List、Get异步调用操作Converse/ConverseStream/Invoke/InvokeStream支持带requestMetadata的调用日志Converse/ConverseStream的视频内容块支持原始字节或 S3 URI多 Agent 协作Multi-Agent Collaboration2.29.26Agents for Amazon Bedrock 及其 Runtime 正式发布多 Agent 协作 SDKSQL 自然语言生成与 Kendra GenAI Index2.29.28GenerateQueryAPI 原生集成 Knowledge Bases支持通过 Bedrock Data Automation 摄取/检索图片支持创建由 Kendra GenAI Index 支撑的 Knowledge BaseRerank API 与流式检索2.29.24RetrieveAndGenerateStream、Rerank API、知识库文档直传、Retrieve 的 Guardrails 支持提示优化Prompt Optimization2.29.18、内联 Agent 调用InvokeInlineAgent2.29.20、提示流 trace 功能2.29.9、提示管理Prompt management2.29.8等Bedrock Evaluation 延迟优化推理2.29.51评估任务支持 latency-optimized inference。3.2 数据存储与分析DynamoDB、Redshift、S3 与数据湖DynamoDB2.29.47 起PITRpoint-in-time-recovery恢复周期变为可按表配置1~35 天2.29.26 支持全局表多区域强一致性预览——UpdateTable新增MultiRegionConsistency属性2.29.12 新增WarmThroughput 预热吞吐CreateTable/UpdateTable可选属性Redshift2.29.26 新增RegisterNamespace/DeregisterNamespace与 Glue Data Catalog 数据共享2.29.13 支持 S3AccessGrants2.29.4 支持 S3 事件集成S3Amazon Simple Storage Service2.29.45 更新CopySource模型正则文档性质2.29.21 新增PutObject/CompleteMultipartUpload 的 ETag 条件写防止对象被意外修改2.29.19 新增条件删除conditional deletes与 write offset bytes 追加写2.29.26 新增S3 Metadata 元数据表Apache Iceberg2.29.24 支持 AWS Dedicated Local Zones2.29.13 更新 ListBuckets 文档以反映 10,000 个通用存储桶默认配额S3 Tables2.29.26首个内置开放表格式支持的云对象存储用于大规模存储表格数据Amazon S3 客户端2.29.2 修复开启crossRegionAccessEnabled时对 opt-in 区域的重定向处理。3.3 计算与容器EC2、ECS、EKS、LambdaEC22.29.51 支持DisconnectOnSessionTimeoutClient VPN2.29.34 的DeleteSecurityGroup响应新增GroupId2.29.30 新增启动后修改实例 network-performance-options 的 API2.29.22 支持EBS 快照定时复制Time-based Copy与跨区域 PrivateLink2.29.19 支持未来日期的 Capacity Reservations、Capacity Blocks、IPAM 组织单元2.29.18 支持 ODCR 启动偏好与实例族引用2.29.17 新增VPC Block Public Access (VPC BPA)2.29.4 支持Security Group VPC Associations 与 Shared Security GroupsECS2.29.17 支持容器镜像 tag 到 digest 的版本一致性配置2.29.19 支持 Container Insights with Enhanced Observability2.29.36 支持enableFaultInjection任务定义参数EKS2.29.34 新增NodeRepairConfig2.29.40 新增DescribeClusterVersions APIKubernetes 版本及终止支持日期Lambda2.29.20 新增ProvisionedPollerConfig2.29.18 支持Node.js 22.x2.29.10 支持Python 3.132.29.9 支持 KMS 客户托管密钥加密 .zip 部署包2.29.1 新增TagsError字段。3.4 网络与边缘Route 53、CloudFront、Elastic Load BalancingRoute 532.29.52 支持墨西哥中部区域 mx-central-12.29.48 支持亚太泰国区域 ap-southeast-72.29.4 新增TLSA、SSHFP、SVCB、HTTPS 记录类型CloudFront2.29.36 支持 VPC Origins 的OriginReadTimeout/OriginKeepaliveTimeout2.29.18 支持 gRPC、VPC origins、Anycast IP Lists2.29.19 支持基于媒体质量分数的 EMPv2 源选择2.29.10 模型迁移至 Smithy行为不变Elastic Load Balancing2.29.19 支持跨可用区 ALB 的 zonal shift及 HTTP 请求/响应头修改2.29.18 支持 Load balancer Capacity Unit 预留。3.5 游戏、消息与集成服务GameLift2.29.52 新增PriorityConfigurationOverride——可在单个StartGameSessionPlacement请求中覆盖游戏会话队列的放置位置优先级2.29.44 支持终止异常状态的游戏会话2.29.11容器舰队container fleets正式 GASQS2.29.44 修正 in-flight 消息数文档20k → 120kSNS2.29.20 为 Archive and Replay 功能新增ArchivePolicy属性EventBridge2.29.24支持通过 PrivateLink 与 VPC Lattice 配置 Connection 调用私有 APIMSK Connect2.29.51支持UpdateConnector更新连接器配置新增 Operations API 监控连接器操作状态。3.6 安全、身份与合规服务STS2.29.13 新增AssumeRoot API返回可用于执行特权任务的短期凭证IAM2.29.13 新增五个 API支持面向组织成员账户使用临时 root 凭证Organizations2.29.24 支持DECLARATIVE_POLICY_EC2策略操作2.29.12 支持 Resource Control Policies 策略操作Access Analyzer2.29.13 支持策略校验与 RCP 外部访问发现2.29.12 未使用访问分析器支持排除账户与资源标签Cognito Identity Provider2.29.20 支持**无密码登录email/SMS OTP、Passkeys/WebAuthn**与 Managed Login 品牌定制AWS Artifact2.29.51 支持将区域 API 调用解析到分区 leader 区域端点。3.7 可观测性与运维CloudWatch Logs2.29.24 新增PutIntegration/GetIntegration/ListIntegrations/DeleteIntegration及QueryLanguage支持2.29.19 支持字段索引与日志转换CloudWatch2.29.15 支持PutMetricData关联实体信息CloudTrail2.29.19 新增 CloudTrail Lake 仪表盘管理 API 与资源策略支持2.29.12 新增基于自然语言生成查询的GenerateQueryAPIX-Ray2.29.19新增 Transaction Search API支持将 span 摄入 CloudWatch Logs 进行大规模索引。四、Bugfixes 专题行为修复与社区贡献除 SDK 核心修复外2.29.x 还包含若干值得关注的专项修复4.1 DynamoDB Enhanced ClientDuration 反序列化精度修复2.29.23修复了 services-custom/dynamodb-enhanced 中DurationAttributeConverter反序列化时将小数部分一律按纳秒处理的问题。查看其实现 DurationAttributeConverter.javaconvertNumber会将数字按小数点拆分为秒与纳秒调整值不足 9 位右侧补零后再解析。旧逻辑对小数部分位数不足时可能产生错误的纳秒放大此版本修正了该换算。4.2 S3 Transfer Manager目录上传转换函数异常不再被吞掉2.29.49修复了 services-custom/s3-transfer-manager 中当UploadDirectoryRequest的请求转换函数抛异常时错误被静默吞掉的问题。修复后如果转换函数抛错完成阶段completion future会以异常完成调用方能够感知失败。4.3 S3 Event Notificationsnull 值反序列化修复2.29.46修复了 services-custom/s3-event-notifications 中S3EventNotification#fromJson遇到 null 值时抛出IllegalArgumentException的问题对应 issue #5730。4.4 v2-migration OpenRewrite recipe并发修复2.29.21社区贡献者 sk-br 模块 OpenRewrite recipe 中的ConcurrentModificationException——用ConcurrentHashMap替换HashMap。4.5 版本回滚与行为还原记录2.29.26 回滚 PR #5704见上文 2.62.29.20 的 WorkSpaces 条目说明WSP-DCV 品牌重塑过程中部分 WSP 字样被误改为 DCV该版本将其还原回 WSP2.29.50 的 STS 条目为描述文案中的拼写修正此类文档修正条目在 2.29.x 中数量较多属于服务端模型文档同步不影响 API 行为。五、Deprecations内部校验和类的弃用2.29.02.29.0 除了默认切换 CRC 实现外还弃用了内部校验和算法类位于 core/checksums。这类类为SdkInternalApi级别的内部实现SDK 不承诺其公共 API 稳定性。对于直接引用了这些类的用户代码建议迁移到java.util.zip的CRC32/CRC32C或在需要与 SDK 集成时改用公开的校验和 SPI见 core/checksums-spi。六、社区贡献者致谢2.29.x 版本线中共有四位外部贡献者获得官方致谢对应修复如下版本贡献者贡献内容2.29.10vsudilovSigV4 仅在未提供时添加 Host 头2.29.21sk-brv2-migration recipe 并发修复ConcurrentHashMap2.29.22XtansiaApacheHttpClient 对 DELETE/GET/HEAD/OPTIONS 请求体处理修复2.29.28APandherDSQL IAM Token 生成工具这体现了该 SDK 的开放治理模式外部 PR 经审核合入后会在对应版本的Contributors段落下公示。七、升级与使用建议性能收益无需配置即可获得升级到 2.29.x 后CRC 默认实现2.29.0与 JSON 解析优化2.29.7自动生效若仍在使用 Java 8CRC 优化不适用建议关注运行时版本IMDS 超时可调在元数据服务不稳定的环境中通过AWS_METADATA_SERVICE_TIMEOUT环境变量/aws.ec2MetadataServiceTimeout系统属性/metadata_service_timeout配置文件调大默认 1 秒的超时可减少凭据获取失败2.29.36重试语义更可预期2.29.28 之后默认重试谓词始终叠加生效自定义RetryCondition时不必再担心默认限流重试被覆盖注意行为回归风险2.29.26 的回滚说明 SDK 对 HTTP 请求体语义保持保守若你的代码依赖所有方法都携带请求体的中间行为应以 2.29.26 之后的行为为准利用新服务能力前确认区域可用性如 Route 53 新区域mx-central-1、ap-southeast-7、DynamoDB 多区域强一致性预览、S3 条件写等均以 AWS 官方区域与服务可用性公告为准。八、进一步阅读本版本线完整原始记录changelogs/2.29.x-CHANGELOG.md其余版本线与总览changelogs、CHANGELOG.mdSDK 版本管理策略VERSIONING.md用户代理与业务指标说明docs/user-agent.md关键实现源码IMDS 超时配置 SdkSystemSetting.java、ProfileProperty.javaDuration 转换器 DurationAttributeConverter.java【免费下载链接】aws-sdk-java-v2The official AWS SDK for Java - Version 2项目地址: https://gitcode.com/GitHub_Trending/aw/aws-sdk-java-v2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AWS SDK for Java v2 2.29.x 版本发布全览核心引擎演进与 52 个版本的服务能力更新解读【免费下载链接】aws-sdk-java-v2The official AWS SDK for Java - Version 2项目地址: https://gitcode.com/GitHub_Trending/aw/aws-sdk-java-v2本指南基于当前仓库中的官方发布记录 changelogs/2.29.x-CHANGELOG.md系统梳理 AWS SDK for Java v2 在 2024 年 10 月 24 日至 2025 年 1 月 14 日期间发布的 2.29.0 ~ 2.29.52 共 52 个版本的完整变更。读完本文你将掌握该版本线中 SDK 核心引擎JSON 协议解析、重试策略、校验和、SigV4、IMDS 超时配置、用户代理等的底层演进细节逐一了解各 AWS 服务GameLift、Route 53、Bedrock 系列、DynamoDB、S3、ECS、EC2 等的新增 API 与行为变更并借助仓库源码定位关键改动的实现位置为升级与排障提供直接依据。一、版本线总览52 个版本的节奏与构成2.29.x 是 AWS SDK for Java v2 的一个长期维护版本线横跨 2024 年第四季度至 2025 年 1 月中旬。该版本线表现出几个鲜明特征高频发布从 2.29.02024-10-24到 2.29.522025-01-14平均每个工作日都有版本产出其中 2024-12-04 一天内发布了 2.29.28 与 2.29.29 两个版本三类变更并存每版均包含Features新功能、Bugfixes缺陷修复个别版本还包含Deprecations弃用声明并以AWS SDK for Java v2条目区分SDK 核心改动与服务能力更新端点元数据常态化更新绝大多数版本都包含 Updated endpoint and partition metadata这是 SDK 随服务端全局基础设施变化新增区域、分区端点调整自动同步的结果例如 Route 53 在 2.29.48 支持亚太泰国区域ap-southeast-7、在 2.29.52 支持墨西哥中部区域mx-central-1。版本命名与发布历史约定可参见 VERSIONING.md 与总览 CHANGELOG.md其余版本线的完整记录位于 changelogs 目录。二、SDK 核心引擎演进从解析、重试到校验和的底层优化2.29.x 对 SDK 运行时的改动集中在协议解析、HTTP 客户端行为、重试机制、签名、校验和与元数据服务配置等方向。这些改动全部标注为AWS SDK for Java v2条目直接决定所有服务客户端的通用行为。2.1 默认启用 Java 内置 CRC32/CRC32C性能与 API 弃用同步落地2.29.02.29.0 是 2.29.x 的起点版本核心变更为SDK 默认改用 Java 内置的 CRC32 与 CRC32C 实现Java 9 环境下从而获得更好的性能同时弃用内部校验和算法类Deprecations。从仓库结构看校验和实现集中在 core/checksums 模块。这次变更的实质是在 Java 9 及以上版本中java.util.zip.CRC32C等 JDK 原生实现经过 JIT 优化后吞吐优于自研实现因此 SDK 将其作为默认路径同时保留自研实现用于兼容较旧 JDK 与特殊场景。用户通常无需任何配置即可受益因为默认值已切换只有显式引用内部校验和类的代码才需要关注弃用警告。2.2 JSON 协议边解析边解组统一反序列化性能2.29.72.29.7 对全部 JSON 协议core/protocols/aws-json-protocol 及其它协议模块做了一项重要的性能优化将解析parsing与解组unmarshalling合二为一而不是先完整解析再逐字段解组。这减少了中间对象的构造与遍历开销使所有基于 JSON 的服务客户端如 DynamoDB、Lambda、S3 的部分 API的反序列化延迟普遍受益。2.3 重试策略默认退避策略统一收敛到 Builder2.29.7同版本还修复了重试策略默认值设置位置不一致的问题此前只有DefaultRetryStrategy的 Builder 方法会设置默认退避策略现在所有重试策略 Builder 都统一按 javadoc 约定设置默认 backoff 策略。重试相关实现位于 core/retries 与 core/retries-spi。这意味着通过RetryPolicy自定义重试时即使不显式指定退避策略也会获得与 javadoc 一致的默认行为避免不同构造路径下行为漂移。2.4 默认重试谓词叠加在用户自定义谓词之上2.29.282.29.28 修复了一个容易踩坑的语义问题SDK 现在会在用户提供的重试谓词之上叠加默认重试谓词。此前若用户自定义了RetryCondition默认的限流/异常判定可能被完全覆盖此版本保证默认重试条件始终生效自定义谓词只做增量扩展。2.5 SigV4 只在缺失时补写 Host 头2.29.102.29.10 修复了签名行为SigV4 计算仅在请求未携带 Host 头时才补充该头避免重复/覆盖已有 Host 头导致的签名不一致。此项由社区贡献者 vsudilov。2.6 回滚所有 HTTP 方法携带请求体实体的变更2.29.262.29.26 做了一次谨慎的回滚撤销 PR #5704——该 PR 曾让所有 HTTP 方法包括 GET/DELETE 等都在请求中包含请求体实体因对部分服务造成回归问题而被整体回退。这说明 SDK 在 HTTP 语义上坚持按方法区分请求体的保守策略避免对服务端行为产生意外影响。2.7 Apache HTTP 客户端DELETE/GET/HEAD/OPTIONS 请求体处理修复2.29.222.29.22 修复了 http-clients/apache-client 中ApacheHttpClient 对 DELETE、GET、HEAD、OPTIONS 请求携带请求体的处理由社区贡献者 Xtansia 提交。此前这些方法在携带 body 时可能被错误处理导致请求发送失败或服务端解析异常修复后这些方法的请求体能够按预期发送。2.8 CRT 客户端GetObject 中途失败的错误上抛2.29.242.29.24 修复了AWS CRT-based S3 客户端http-clients/aws-crt-client 与 services/s3 的 CRT 模式中 GetObject 请求进行到一半失败时错误未被抛出的问题对应 issue #5631。修复后失败会正确暴露给调用方而不是静默丢失。2.9 新增AWS_METADATA_SERVICE_TIMEOUT统一配置 IMDS 连接与读取超时2.29.362.29.36 引入了一项面向 EC2 元数据服务IMDS的可配置能力新增环境变量AWS_METADATA_SERVICE_TIMEOUT、系统属性aws.ec2MetadataServiceTimeout以及配置文件属性metadata_service_timeout用于同时配置 InstanceProfileCredentialsProvider 与 IMDS 客户端的连接超时和读取超时单位秒。结合仓库源码可以确认其底层实现系统属性定义于 core/sdk-core/src/main/java/software/amazon/awssdk/core/SdkSystemSetting.javaAWS_METADATA_SERVICE_TIMEOUT(aws.ec2MetadataServiceTimeout, 1)默认值为 1 秒且该值同时作用于 socket connect 与 read 两个阶段配置文件属性定义于 core/profiles/src/main/java/software/amazon/awssdk/profiles/ProfileProperty.javaMETADATA_SERVICE_TIMEOUT metadata_service_timeout读取与解析逻辑位于 core/auth/src/main/java/software/amazon/awssdk/auth/credentials/internal/Ec2MetadataConfigProvider.java 与 core/imds/src/main/java/software/amazon/awssdk/imds/internal/Ec2MetadataConfigProvider.java对应测试见 core/auth/src/test/java/software/amazon/awssdk/auth/credentials/internal/Ec2MetadataServiceTimeoutResolverTest.java。配置优先级与环境变量、系统属性、配置文件三者一致。典型用法示例# 环境变量方式单位秒 export AWS_METADATA_SERVICE_TIMEOUT2# ~/.aws/config 配置文件方式 [default] metadata_service_timeout 2// 系统属性方式在启动参数或代码中设置 System.setProperty(aws.ec2MetadataServiceTimeout, 2);该配置对网络状况不佳的 EC2、EKS 等运行环境尤其重要调大超时值可降低元数据服务偶发延迟导致的凭据获取失败概率。2.10 用户代理业务指标段m/功能使用跟踪的新格式2.29.42.29.4 引入了在用户代理字符串中跟踪功能使用情况的新机制新增m/业务指标元数据段功能以 Base64 编码字符串表示此前用文本表示的旧格式如 DynamoDB Enhanced Client 记为hll/ddb-enh迁移到新格式如d。这属于 SDK 遥测/可观测性改进不影响功能行为但会改变请求头中的 User-Agent 内容。用户代理构造机制详见 docs/user-agent.md。2.11 事件流异常反序列化修复与 CRT 类加载方式调整2.29.5 / 2.29.62.29.5 修复了事件流eventstream异常无法正确反序列化为预期异常类型的问题2.29.6 将CRT Checksum 类的加载方式改为通过 ClassLoader 加载而非直接引用 CRT 类降低类加载器隔离环境如应用服务器、插件容器下的链接失败风险。三、重点服务能力更新按服务维度2.29.x 覆盖了 AWS 全线服务的 API 演进。以下是按服务聚类的高价值变更3.1 生成式 AI 服务Bedrock 家族成为更新最密集的板块Bedrock 相关服务Amazon Bedrock、Amazon Bedrock Runtime、Agents for Amazon Bedrock、Agents for Amazon Bedrock Runtime、Data Automation 及 Runtime在 2.29.x 中更新最为密集几乎贯穿整个版本线智能提示路由Intelligent Prompt Router2.29.28新增ListPromptRouters、GetPromptRouter两个 API并在Invoke、InvokeStream、Converse、ConverseStream中支持Guardrails 图像内容过滤2.29.28Bedrock Runtime 新增图像内容过滤能力Bedrock Marketplace2.29.28支持自托管模型的更大范围兼容异步调用Async Invoke2.29.26新增Start、List、Get异步调用操作Converse/ConverseStream/Invoke/InvokeStream支持带requestMetadata的调用日志Converse/ConverseStream的视频内容块支持原始字节或 S3 URI多 Agent 协作Multi-Agent Collaboration2.29.26Agents for Amazon Bedrock 及其 Runtime 正式发布多 Agent 协作 SDKSQL 自然语言生成与 Kendra GenAI Index2.29.28GenerateQueryAPI 原生集成 Knowledge Bases支持通过 Bedrock Data Automation 摄取/检索图片支持创建由 Kendra GenAI Index 支撑的 Knowledge BaseRerank API 与流式检索2.29.24RetrieveAndGenerateStream、Rerank API、知识库文档直传、Retrieve 的 Guardrails 支持提示优化Prompt Optimization2.29.18、内联 Agent 调用InvokeInlineAgent2.29.20、提示流 trace 功能2.29.9、提示管理Prompt management2.29.8等Bedrock Evaluation 延迟优化推理2.29.51评估任务支持 latency-optimized inference。3.2 数据存储与分析DynamoDB、Redshift、S3 与数据湖DynamoDB2.29.47 起PITRpoint-in-time-recovery恢复周期变为可按表配置1~35 天2.29.26 支持全局表多区域强一致性预览——UpdateTable新增MultiRegionConsistency属性2.29.12 新增WarmThroughput 预热吞吐CreateTable/UpdateTable可选属性Redshift2.29.26 新增RegisterNamespace/DeregisterNamespace与 Glue Data Catalog 数据共享2.29.13 支持 S3AccessGrants2.29.4 支持 S3 事件集成S3Amazon Simple Storage Service2.29.45 更新CopySource模型正则文档性质2.29.21 新增PutObject/CompleteMultipartUpload 的 ETag 条件写防止对象被意外修改2.29.19 新增条件删除conditional deletes与 write offset bytes 追加写2.29.26 新增S3 Metadata 元数据表Apache Iceberg2.29.24 支持 AWS Dedicated Local Zones2.29.13 更新 ListBuckets 文档以反映 10,000 个通用存储桶默认配额S3 Tables2.29.26首个内置开放表格式支持的云对象存储用于大规模存储表格数据Amazon S3 客户端2.29.2 修复开启crossRegionAccessEnabled时对 opt-in 区域的重定向处理。3.3 计算与容器EC2、ECS、EKS、LambdaEC22.29.51 支持DisconnectOnSessionTimeoutClient VPN2.29.34 的DeleteSecurityGroup响应新增GroupId2.29.30 新增启动后修改实例 network-performance-options 的 API2.29.22 支持EBS 快照定时复制Time-based Copy与跨区域 PrivateLink2.29.19 支持未来日期的 Capacity Reservations、Capacity Blocks、IPAM 组织单元2.29.18 支持 ODCR 启动偏好与实例族引用2.29.17 新增VPC Block Public Access (VPC BPA)2.29.4 支持Security Group VPC Associations 与 Shared Security GroupsECS2.29.17 支持容器镜像 tag 到 digest 的版本一致性配置2.29.19 支持 Container Insights with Enhanced Observability2.29.36 支持enableFaultInjection任务定义参数EKS2.29.34 新增NodeRepairConfig2.29.40 新增DescribeClusterVersions APIKubernetes 版本及终止支持日期Lambda2.29.20 新增ProvisionedPollerConfig2.29.18 支持Node.js 22.x2.29.10 支持Python 3.132.29.9 支持 KMS 客户托管密钥加密 .zip 部署包2.29.1 新增TagsError字段。3.4 网络与边缘Route 53、CloudFront、Elastic Load BalancingRoute 532.29.52 支持墨西哥中部区域 mx-central-12.29.48 支持亚太泰国区域 ap-southeast-72.29.4 新增TLSA、SSHFP、SVCB、HTTPS 记录类型CloudFront2.29.36 支持 VPC Origins 的OriginReadTimeout/OriginKeepaliveTimeout2.29.18 支持 gRPC、VPC origins、Anycast IP Lists2.29.19 支持基于媒体质量分数的 EMPv2 源选择2.29.10 模型迁移至 Smithy行为不变Elastic Load Balancing2.29.19 支持跨可用区 ALB 的 zonal shift及 HTTP 请求/响应头修改2.29.18 支持 Load balancer Capacity Unit 预留。3.5 游戏、消息与集成服务GameLift2.29.52 新增PriorityConfigurationOverride——可在单个StartGameSessionPlacement请求中覆盖游戏会话队列的放置位置优先级2.29.44 支持终止异常状态的游戏会话2.29.11容器舰队container fleets正式 GASQS2.29.44 修正 in-flight 消息数文档20k → 120kSNS2.29.20 为 Archive and Replay 功能新增ArchivePolicy属性EventBridge2.29.24支持通过 PrivateLink 与 VPC Lattice 配置 Connection 调用私有 APIMSK Connect2.29.51支持UpdateConnector更新连接器配置新增 Operations API 监控连接器操作状态。3.6 安全、身份与合规服务STS2.29.13 新增AssumeRoot API返回可用于执行特权任务的短期凭证IAM2.29.13 新增五个 API支持面向组织成员账户使用临时 root 凭证Organizations2.29.24 支持DECLARATIVE_POLICY_EC2策略操作2.29.12 支持 Resource Control Policies 策略操作Access Analyzer2.29.13 支持策略校验与 RCP 外部访问发现2.29.12 未使用访问分析器支持排除账户与资源标签Cognito Identity Provider2.29.20 支持**无密码登录email/SMS OTP、Passkeys/WebAuthn**与 Managed Login 品牌定制AWS Artifact2.29.51 支持将区域 API 调用解析到分区 leader 区域端点。3.7 可观测性与运维CloudWatch Logs2.29.24 新增PutIntegration/GetIntegration/ListIntegrations/DeleteIntegration及QueryLanguage支持2.29.19 支持字段索引与日志转换CloudWatch2.29.15 支持PutMetricData关联实体信息CloudTrail2.29.19 新增 CloudTrail Lake 仪表盘管理 API 与资源策略支持2.29.12 新增基于自然语言生成查询的GenerateQueryAPIX-Ray2.29.19新增 Transaction Search API支持将 span 摄入 CloudWatch Logs 进行大规模索引。四、Bugfixes 专题行为修复与社区贡献除 SDK 核心修复外2.29.x 还包含若干值得关注的专项修复4.1 DynamoDB Enhanced ClientDuration 反序列化精度修复2.29.23修复了 services-custom/dynamodb-enhanced 中DurationAttributeConverter反序列化时将小数部分一律按纳秒处理的问题。查看其实现 DurationAttributeConverter.javaconvertNumber会将数字按小数点拆分为秒与纳秒调整值不足 9 位右侧补零后再解析。旧逻辑对小数部分位数不足时可能产生错误的纳秒放大此版本修正了该换算。4.2 S3 Transfer Manager目录上传转换函数异常不再被吞掉2.29.49修复了 services-custom/s3-transfer-manager 中当UploadDirectoryRequest的请求转换函数抛异常时错误被静默吞掉的问题。修复后如果转换函数抛错完成阶段completion future会以异常完成调用方能够感知失败。4.3 S3 Event Notificationsnull 值反序列化修复2.29.46修复了 services-custom/s3-event-notifications 中S3EventNotification#fromJson遇到 null 值时抛出IllegalArgumentException的问题对应 issue #5730。4.4 v2-migration OpenRewrite recipe并发修复2.29.21社区贡献者 sk-br 模块 OpenRewrite recipe 中的ConcurrentModificationException——用ConcurrentHashMap替换HashMap。4.5 版本回滚与行为还原记录2.29.26 回滚 PR #5704见上文 2.62.29.20 的 WorkSpaces 条目说明WSP-DCV 品牌重塑过程中部分 WSP 字样被误改为 DCV该版本将其还原回 WSP2.29.50 的 STS 条目为描述文案中的拼写修正此类文档修正条目在 2.29.x 中数量较多属于服务端模型文档同步不影响 API 行为。五、Deprecations内部校验和类的弃用2.29.02.29.0 除了默认切换 CRC 实现外还弃用了内部校验和算法类位于 core/checksums。这类类为SdkInternalApi级别的内部实现SDK 不承诺其公共 API 稳定性。对于直接引用了这些类的用户代码建议迁移到java.util.zip的CRC32/CRC32C或在需要与 SDK 集成时改用公开的校验和 SPI见 core/checksums-spi。六、社区贡献者致谢2.29.x 版本线中共有四位外部贡献者获得官方致谢对应修复如下版本贡献者贡献内容2.29.10vsudilovSigV4 仅在未提供时添加 Host 头2.29.21sk-brv2-migration recipe 并发修复ConcurrentHashMap2.29.22XtansiaApacheHttpClient 对 DELETE/GET/HEAD/OPTIONS 请求体处理修复2.29.28APandherDSQL IAM Token 生成工具这体现了该 SDK 的开放治理模式外部 PR 经审核合入后会在对应版本的Contributors段落下公示。七、升级与使用建议性能收益无需配置即可获得升级到 2.29.x 后CRC 默认实现2.29.0与 JSON 解析优化2.29.7自动生效若仍在使用 Java 8CRC 优化不适用建议关注运行时版本IMDS 超时可调在元数据服务不稳定的环境中通过AWS_METADATA_SERVICE_TIMEOUT环境变量/aws.ec2MetadataServiceTimeout系统属性/metadata_service_timeout配置文件调大默认 1 秒的超时可减少凭据获取失败2.29.36重试语义更可预期2.29.28 之后默认重试谓词始终叠加生效自定义RetryCondition时不必再担心默认限流重试被覆盖注意行为回归风险2.29.26 的回滚说明 SDK 对 HTTP 请求体语义保持保守若你的代码依赖所有方法都携带请求体的中间行为应以 2.29.26 之后的行为为准利用新服务能力前确认区域可用性如 Route 53 新区域mx-central-1、ap-southeast-7、DynamoDB 多区域强一致性预览、S3 条件写等均以 AWS 官方区域与服务可用性公告为准。八、进一步阅读本版本线完整原始记录changelogs/2.29.x-CHANGELOG.md其余版本线与总览changelogs、CHANGELOG.mdSDK 版本管理策略VERSIONING.md用户代理与业务指标说明docs/user-agent.md关键实现源码IMDS 超时配置 SdkSystemSetting.java、ProfileProperty.javaDuration 转换器 DurationAttributeConverter.java【免费下载链接】aws-sdk-java-v2The official AWS SDK for Java - Version 2项目地址: https://gitcode.com/GitHub_Trending/aw/aws-sdk-java-v2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
