公司网络下Node.js上传超1MB文件到S3 Bucket报500错误求助

针对公司网络环境下，Node.js AWS SDK上传大于1MB文件到S3触发500错误（小文件正常、本地环境及AWS CLI上传无异常）的问题，可通过以下代码调整解决：

核心调整方案 #

1. 强制启用分块上传并指定分块大小 #

公司网络可能对单次HTTP请求大小有限制，显式设置小于1MB的分块大小，确保每个分块请求和小文件请求行为一致：

const AWS = require('aws-sdk');
const fs = require('fs');

const s3 = new AWS.S3({
  region: 'your-bucket-region', // 必须显式指定Bucket所在区域
  s3ForcePathStyle: true,
  httpOptions: {
    proxy: 'http://your-company-proxy:port' // 配置与AWS CLI一致的代理地址
  }
});

async function uploadLargeFile() {
  const uploadParams = {
    Bucket: 'your-bucket-name',
    Key: 'target-file-key',
    Body: fs.createReadStream('./local-large-file'),
    PartSize: 900 * 1024, // 设置为900KB，确保小于1MB阈值
    QueueSize: 4 // 并发分块数，可根据网络情况调整
  };

  try {
    const uploadResult = await s3.upload(uploadParams).promise();
    console.log('上传成功:', uploadResult.Location);
  } catch (err) {
    console.error('上传失败:', err);
  }
}

uploadLargeFile();

2. 对齐AWS CLI的代理配置 #

AWS CLI会自动读取系统代理或本地配置中的代理信息，但Node.js SDK需要显式配置。检查AWS CLI使用的代理地址，在SDK的httpOptions.proxy中设置相同值，确保请求走一致的网络通道。

3. 启用调试日志排查细节 #

开启SDK调试日志，查看请求的实际URL、头部信息及代理交互情况，定位网络层面的异常：

AWS.config.logger = console;
AWS.config.logLevel = 'debug';

原因分析 #

AWS CLI与Node.js AWS SDK底层均基于HTTP/HTTPS协议，但默认配置存在差异：

• CLI对大文件的分块上传逻辑更适配代理环境，且代理配置继承系统设置；
• SDK的自动分块逻辑在公司防火墙/代理下可能触发异常，导致大文件请求被拦截；
• 错误信息中region为null，未显式指定区域会导致请求路径不符合S3规范，触发500错误。

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