升级AWS SDK v3后集成Multer S3 v3出现类型错误：缺失S3属性

问题根源 #

1. AWS SDK v3中，@aws-sdk/client-s3的客户端类是S3Client，而非v2的S3类，你导入S3属于误用v2写法，这是第二个类型错误的原因。
2. multer-s3 v3需要依赖@aws-sdk/lib-storage来适配S3Client的命令式调用逻辑（v3客户端通过send方法执行操作，而非v2的直接方法挂载），缺少这个依赖会导致类型提示缺少abortMultipartUpload等方法。

解决步骤 #

1. 安装完整兼容的依赖包：

npm install @aws-sdk/client-s3@3.496.0 @aws-sdk/lib-storage@3.496.0 multer-s3@3.0.1 multer

（确保@aws-sdk系列包版本一致，避免兼容性问题）

2. 修正代码，使用正确的S3Client：

import { S3Client } from '@aws-sdk/client-s3';
import multer from 'multer';
import multerS3 from 'multer-s3';

const s3Client = new S3Client({
  region: 'us-east-2',
  credentials: {
    accessKeyId: 'foobar',
    secretAccessKey: 'fizzbuzz',
  },
});

export const upload = multer({
  storage: multerS3({
    s3: s3Client, // 传入正确的S3Client实例
    bucket: 'your-bucket-name', // 替换为实际存储桶名称
    key: (req, file, cb) => {
      // 自定义文件键生成逻辑，示例如下
      cb(null, `uploads/${Date.now()}-${file.originalname}`);
    },
  }),
});

额外说明 #

• 不要尝试导入@aws-sdk/client-s3中的S3，v3中不存在这个导出，之前的类型提示错误就是因为误用了这个不存在的类。
• 如果仍有类型警告，可检查multer-s3的类型定义是否与当前AWS SDK版本兼容，必要时清理node_modules并重新安装依赖。

内容的提问来源于stack exchange，提问作者Mix Master Mike