AWS SDK Ruby中EC2元数据服务端口配置问题的分析与修复

在AWS SDK Ruby的3.191.4版本中，开发者发现了一个关于EC2元数据服务(IMDS)端点配置的异常行为。当通过环境变量AWS_EC2_METADATA_SERVICE_ENDPOINT指定自定义端口时，SDK会忽略端口设置而始终尝试连接默认的80端口。

问题现象

开发者在使用aws-sdk-ssm组件时，通过设置环境变量：

AWS_EC2_METADATA_SERVICE_ENDPOINT=http://127.0.0.1:9099

期望SDK能够连接到本地的9099端口获取实例凭证。然而实际运行时，SDK仍然尝试连接80端口，导致连接被拒绝的错误。

技术分析

通过查看源码发现，问题出在EC2Metadata类处理端点URI的逻辑上。虽然环境变量被正确解析并获取了主机地址，但在端口处理上存在缺陷：

1. 代码中默认将@port成员变量初始化为80
2. 解析URI时没有优先使用URI对象中的端口号
3. 导致无论环境变量中指定什么端口，最终都会回退到默认的80端口

解决方案

AWS SDK Ruby团队迅速响应并修复了这个问题。修复方案主要包含：

1. 修改端口获取逻辑，优先使用URI对象中的端口号
2. 当URI中未指定端口时，才回退到默认端口
3. 保持向后兼容性，不影响现有代码的行为

实际应用场景

这个修复特别适用于以下开发场景：

1. 本地开发环境模拟IMDS服务（如使用aws-vault等工具）
2. 需要避免使用特权端口(80)的情况
3. 多服务共存时需要灵活配置不同端口

临时解决方案

在修复版本发布前，开发者可以通过显式指定port参数来临时解决：

Aws::SSM::Client.new(
  region: "ap-southeast-2",
  credentials: Aws::InstanceProfileCredentials.new(port: 9099)
)

总结

这个问题的修复体现了AWS SDK Ruby团队对开发者体验的重视。通过正确处理环境变量中的端口配置，使得本地开发和测试更加灵活方便。建议开发者及时更新到包含此修复的版本，以获得更好的开发体验。

对于Ruby开发者来说，理解SDK的凭证获取机制和配置方式，能够帮助更好地构建可靠的AWS应用程序。特别是在混合云和本地开发环境中，灵活配置元数据服务端点的能力显得尤为重要。