记录 Amazon S3 上传异常的方法

在.NET应用中记录Amazon S3上传异常时，可以采用以下几种方法实现高效的问题诊断和日志管理。

使用AWS SDK的日志功能
AWS SDK for .NET内置了日志记录功能，通过配置AWSConfigs.LoggingConfig可以启用日志输出。设置日志级别为LoggingOptions可捕获详细的请求和异常信息。例如：

AWSConfigs.LoggingConfig.LogTo = LoggingOptions.Console;
AWSConfigs.LoggingConfig.LogResponses = ResponseLoggingOption.OnError;
AWSConfigs.LoggingConfig.LogMetrics = true;

结构化异常处理
在调用S3上传方法时（如PutObjectAsync），捕获AmazonS3Exception并记录其关键属性：

try 
{
    var response = await s3Client.PutObjectAsync(request);
}
catch (AmazonS3Exception ex)
{
    Console.WriteLine($"S3 Error: {ex.ErrorCode}, HTTP {ex.StatusCode}");
    Console.WriteLine($"Request ID: {ex.RequestId}, Extended: {ex.Message}");
}

集成第三方日志框架
结合Serilog或NLog等框架，将异常信息写入文件或日志系统。例如使用Serilog记录上下文信息：

catch (AmazonServiceException ex)
{
    Log.Error(ex, "S3上传失败. Bucket: {Bucket}, Key: {Key}", 
        request.BucketName, request.Key);
}

网络请求诊断
对于疑难问题，启用AWS SDK的HTTP诊断日志。在app.config中添加配置：

<system.diagnostics>
    <switches>
        <add name="Amazon" value="Verbose" />
    </switches>
</system.diagnostics>

重试策略监控
通过配置ClientConfig的RetryPolicy并订阅事件，记录重试行为：

var config = new AmazonS3Config {
    RetryPolicy = new ExponentialRetry(maxRetries: 3),
    MaxErrorRetry = 2
};
config.AfterResponseEvent += (sender, args) => {
    if (args.Response != null) 
        Debug.WriteLine($"Retry attempt: {args.Response.ResponseMetadata.Metadata}");
};

关键异常类型

• AmazonS3Exception: 包含S3特定错误代码（如NoSuchBucket）
• AmazonClientException: 客户端配置或网络问题
• TaskCanceledException: 请求超时或取消

日志字段建议

1. 请求ID（ex.RequestId）
2. S3错误代码（ex.ErrorCode）
3. HTTP状态码
4. 操作类型（PutObject/UploadPart等）
5. 关键参数（Bucket/Key/PartNumber等）

通过组合使用这些方法，可以全面捕获上传过程中的异常信息，便于后续分析存储桶权限、网络问题或数据完整性问题。