使用@aws-sdk/client-s3 v3.481.0时ListBucketsCommand类型不匹配报错求助

AI 小北

2026-7-3

问题解决：@aws-sdk/client-s3 send方法类型错误

错误核心原因

命令参数混淆：ListBucketsCommand 用于列出当前AWS账号下所有S3存储桶，它不需要 Bucket 和 MaxKeys 参数——你把它和用于列出指定存储桶内对象的ListObjectsV2Command搞混了。
类型不兼容触发：错误提示的类型不匹配问题，本质是传递了错误的参数给ListBucketsCommand，导致命令实例不符合send方法的参数要求。

修正后的代码

先确保正确导入所需模块：

import { S3Client, ListBucketsCommand, ListObjectsV2Command } from "@aws-sdk/client-s3";

场景1：列出所有存储桶

const S3_Config = {
  region: process.env.S3_REGION,
  credentials: {
    accessKeyId: process.env.S3_ACCESS_KEY_ID,
    secretAccessKey: process.env.S3_ACCESS_SECRET_KEY,
  },
};
const s3_client = new S3Client(S3_Config);

// ListBucketsCommand 无需额外参数
const _command = new ListBucketsCommand({});
const response = await s3_client.send(_command);
console.log(response.Buckets);

场景2：列出指定存储桶内的对象

改用ListObjectsV2Command实现你的需求：

const S3_Config = {
  region: process.env.S3_REGION,
  credentials: {
    accessKeyId: process.env.S3_ACCESS_KEY_ID,
    secretAccessKey: process.env.S3_ACCESS_SECRET_KEY,
  },
};
const s3_client = new S3Client(S3_Config);

const s3_params = {
  Bucket: process.env.S3_BUCKET_NAME, // 必填
  MaxKeys: 20,
};

const _command = new ListObjectsV2Command(s3_params);
const response = await s3_client.send(_command);
console.log(response.Contents);