如何使用AWS SDK JS v3从S3协议URL获取存储对象？

API 探路者

2026-9-25

解决方法

AWS SDK for JavaScript v3 没有内置直接接收s3://协议URL作为入参的API，你需要先解析S3 URL提取出存储桶名（Bucket）和对象键（Key），再传入GetObjectCommand调用即可。

1. 编写S3 URL解析函数

推荐用Node.js内置的URL模块实现，自动处理特殊字符编码，兼容性更好：

const { URL } = require('url');

function parseS3Url(s3Url) {
  const parsedUrl = new URL(s3Url);
  if (parsedUrl.protocol !== 's3:') {
    throw new Error('Invalid S3 URL: must use s3:// protocol');
  }
  return {
    // s3://后的第一部分为存储桶名
    Bucket: parsedUrl.hostname,
    // 路径部分去掉开头的斜杠即为对象键
    Key: parsedUrl.pathname.slice(1)
  };
}

2. 完整调用示例

// 导入SDK依赖
const { S3Client, GetObjectCommand } = require('@aws-sdk/client-s3');
// Node环境下用于处理返回的流式响应，浏览器环境可使用@aws-sdk/util-stream-browser
const { sdkStreamMixin } = require('@aws-sdk/util-stream-node');

// 初始化S3客户端，替换为你自己的AWS区域
const s3Client = new S3Client({ region: 'us-east-1' });

async function getObjectFromS3Url(s3Url) {
  // 解析URL获取必填参数
  const { Bucket, Key } = parseS3Url(s3Url);
  // 构造请求命令
  const command = new GetObjectCommand({ Bucket, Key });
  // 发送请求
  const response = await s3Client.send(command);
  
  // 以下为响应处理逻辑，可根据你的业务需求调整
  // 示例：将流转换为字符串返回
  const stream = sdkStreamMixin(response.Body);
  return stream.transformToString();
}

// 测试调用
getObjectFromS3Url('s3://mybucket/data.txt')
  .then(fileContent => console.log('文件内容：', fileContent))
  .catch(error => console.error('拉取对象失败：', error));