AWS SDK v3 PutObjectCommand遇socket hang up错误，v2 putObject正常

问题现象 #

Lambda函数从临时存储向S3上传约50MB文件时，使用AWS SDK v3的PutObjectCommand调用失败，报错socket hang up（错误码ECONNRESET）；此前上传更大文件无异常，改用AWS SDK v2的putObject方法则可正常执行。

可能的根因排查方向 #

• SDK v3默认配置差异：AWS SDK v3与v2在HTTP客户端超时、连接池管理、请求复用策略上存在默认值差异，50MB文件的上传场景恰好触发了v3默认配置下的网络限制。
• Lambda环境网络适配问题：Lambda执行环境的网络连接受资源配额约束，SDK v3的连接管理逻辑可能与该环境的网络特性适配性不如v2，导致连接被过早回收。
• 流处理逻辑差异：SDK v3处理文件流的分块逻辑、缓冲区设置与v2不同，可能在传输过程中引发连接中断。

可行的解决/排查步骤 #

• 自定义SDK v3的HTTP客户端配置：手动调整超时时间与连接池参数，适配Lambda环境：

  import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
  import { NodeHttpHandler } from "@smithy/node-http-handler";
  
  const s3Client = new S3Client({
    region: "你的区域",
    requestHandler: new NodeHttpHandler({
      connectionTimeout: 30000, // 30秒连接超时
      socketTimeout: 60000, // 60秒套接字超时
      maxSockets: 5, // 调整连接池大小
    }),
  });
  

• 切换为分块上传方式：使用SDK v3的CreateMultipartUploadCommand、UploadPartCommand和CompleteMultipartUploadCommand拆分文件上传，规避单次请求的连接风险。
• 调整Lambda资源配置：提升Lambda的内存配额（内存越高，网络带宽上限越高），排除带宽不足导致的传输中断。
• 增强日志排查：在Lambda中添加详细日志，记录请求参数、SDK版本、执行环境信息，精准定位触发ECONNRESET的场景。

内容的提问来源于stack exchange，提问作者Mandeep Singh