AWS SDK for .NET 中 S3 多部分上传取消问题的分析与解决

问题背景

在 AWS SDK for .NET 的 S3 文件上传功能中，开发者发现当使用 TransferUtility 进行多部分上传时，即使传递了取消令牌(CancellationToken)，上传过程也无法被中断。这个问题在 Windows 11 系统上的 .NET 10 环境中尤为明显。

问题现象

开发者在使用 TransferUtility 进行大文件上传时，通常会设置取消令牌以便在需要时中断上传过程。然而，实际测试表明，即使调用了 CancellationTokenSource 的 Cancel 方法，上传任务仍会继续执行直至完成，取消操作完全无效。

技术分析

通过深入分析 SDK 源码，发现问题出在 MultipartUploadCommand 类的 UploadUnseekableStreamAsync 方法中。该方法在处理不可寻址流(unseekable stream)上传时，没有将取消令牌传递给内部执行的异步函数。这种设计缺陷导致上层传递的取消信号无法传递到实际执行上传操作的底层方法中。

解决方案

开发团队通过修改 MultipartUploadCommand 类的实现，确保取消令牌能够正确传递到所有异步操作中。具体修改包括：

1. 在 UploadUnseekableStreamAsync 方法中正确传递取消令牌参数
2. 确保所有内部异步调用都接收并处理取消令牌
3. 完善取消逻辑，确保上传任务能够及时响应取消请求

修复版本

该问题已在 AWSSDK.S3 4.0.1.1 版本中得到修复。开发者只需升级到此版本或更高版本，即可正常使用取消功能。

最佳实践

对于需要支持取消操作的 S3 文件上传场景，建议开发者：

1. 始终使用最新版本的 AWSSDK.S3 包
2. 对于大文件上传，优先考虑使用多部分上传方式
3. 合理设置取消超时时间，避免资源浪费
4. 在上传过程中监控取消令牌状态，及时释放相关资源

总结

AWS SDK for .NET 团队快速响应并修复了 S3 多部分上传取消功能的问题，体现了对开发者体验的重视。通过这次问题的解决，也提醒开发者在实现异步操作时，要特别注意取消令牌的传递和处理，确保系统资源的合理利用和用户体验的流畅性。