使用AWS SDK v3向SQS队列发消息时遇类型不匹配错误

问题根源 #

你遇到的TypeScript类型错误是由于AWS SDK v3各客户端包的依赖版本不一致导致的。错误提示明确显示@smithy/types的MiddlewareStack类型在client-s3和client-sqs的子依赖中版本不兼容，缺少identifyOnResolve属性，进而导致SendMessageCommand与客户端send方法的类型不匹配。

解决方案 #

1. 统一所有AWS SDK客户端包版本 #

打开package.json，确保所有@aws-sdk/*开头的包（包括@aws-sdk/client-sqs、@aws-sdk/client-s3等）使用完全相同的版本号。示例：

{
  "dependencies": {
    "@aws-sdk/client-sqs": "^3.379.1",
    "@aws-sdk/client-s3": "^3.379.1",
    // 其他AWS SDK包也保持同一版本
  }
}

2. 清理并重新安装依赖 #

执行命令清理现有依赖并重新安装，确保依赖树无冲突：

# 删除node_modules和锁文件
rm -rf node_modules package-lock.json
# 重新安装依赖
npm install

若使用yarn：

rm -rf node_modules yarn.lock
yarn install

3. 合并重复依赖 #

使用npm/yarn的dedupe命令合并重复子依赖，解决版本冲突：

npm dedupe
# 或
yarn dedupe

4. 验证SQS客户端创建逻辑 #

检查getSQSclient函数实现，确保正确导入并初始化SQSClient，未混用其他客户端的类型或配置。示例：

import { SQSClient } from "@aws-sdk/client-sqs";

export async function getSQSclient() {
  return new SQSClient({
    region: process.env.AWS_REGION,
    // 其他必要配置
  });
}

额外注意事项 #

• 避免在项目中混用不同版本的AWS SDK v3客户端包，AWS官方要求所有客户端包版本保持一致以避免依赖冲突。
• 若使用npm的^版本前缀，注意后续npm install可能自动升级小版本，建议锁定具体版本号（去掉^）或使用package-lock.json固定依赖版本。

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