AWS SDK Rust中ECS凭证提供程序忽略查询参数的问题解析

问题背景

在AWS SDK Rust的1.5.10版本中，ECS凭证提供程序(EcsCredentialsProvider)存在一个关键缺陷：当通过AWS_CONTAINER_CREDENTIALS_RELATIVE_URI环境变量传递包含查询参数的URI时，这些查询参数会被完全忽略。这个问题影响了在ECS或EKS环境中需要向凭证服务传递额外参数的所有应用场景。

技术细节分析

问题的根源在于代码中对URI的处理方式。在aws-config库的ecs.rs文件中，开发者使用了uri.path()方法来提取路径信息，但这个方法会丢弃URI中的查询参数部分。正确的做法应该是使用uri.path_and_query()方法，该方法会保留完整的路径和查询字符串。

原始错误代码片段：

let path = uri.path().to_string();

修复后的正确代码：

let path = uri.path_and_query().unwrap().to_string();

影响范围

这个缺陷会导致以下问题：

1. 任何需要通过查询参数向ECS凭证服务传递额外信息的应用都会失败
2. 依赖查询参数进行服务路由或认证的凭证服务将无法正常工作
3. 使用类似"/my-credentials/?applicationName=test2024"格式URI的应用会丢失applicationName参数

问题复现

开发者可以通过以下步骤复现该问题：

1. 设置环境变量：

std::env::set_var("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "/my-credentials/?applicationName=test2024");

2. 创建ECS凭证提供程序并初始化AWS配置

3. 使用网络工具(netcat)监听请求会发现查询参数丢失

解决方案

该问题已在2025年1月23日的发布版本中得到修复。修复方案简单但有效：将path()方法替换为path_and_query()方法，确保查询参数能够正确传递。

对于无法立即升级的用户，可以考虑以下临时解决方案：

1. 修改凭证服务端，不再依赖查询参数
2. 使用自定义凭证提供程序实现
3. 将必要信息编码到路径中而非查询参数

最佳实践

为避免类似问题，建议开发者在处理URI时：

1. 明确区分路径(path)和查询(query)部分
2. 使用专门的URI解析库而非字符串操作
3. 编写单元测试验证URI各部分的正确传递
4. 在文档中明确说明URI参数的处理方式

总结

AWS SDK Rust团队快速响应并修复了这个影响ECS凭证提供程序功能的缺陷。这体现了开源社区对问题的高效处理能力。开发者应当保持SDK版本的及时更新，以获得最佳的功能支持和安全性保障。