如何正确使用 AWS SDK v3 的 SNS 客户端发送短信（SMS）-js教程-PHP中文网

如何正确使用 AWS SDK v3 的 SNS 客户端发送短信（SMS）

本文详解使用 @aws-sdk/client-sns 发送短信失败的常见原因，重点指出缺失的 Origination 参数和显式指定 region 的关键作用，并提供可立即验证的完整代码示例与配置要点。

本文详解使用 `@aws-sdk/client-sns` 发送短信失败的常见原因，重点指出缺失的 `origination` 参数和显式指定 `region` 的关键作用，并提供可立即验证的完整代码示例与配置要点。

在迁移到 AWS SDK for JavaScript v3 后，许多开发者发现 SNSClient.publish() 调用返回成功响应（HTTP 200 + MessageId），但目标手机号始终收不到短信——这并非代码逻辑错误，而是 SNS 短信发送机制的关键配置被忽略。

✅ 核心问题与修复方案

AWS SNS 发送 SMS 到北美（如美国、加拿大）号码时，必须显式指定发件人身份（即“发件号码”或“短代码”），否则消息虽被接受，却因合规性校验失败而静默丢弃。v2 SDK 可能隐式处理部分逻辑，但 v3 要求完全显式声明。

1. 添加 OriginationNumber（关键！）

SNS 要求通过 OriginationNumber 指定经 Amazon Pinpoint 验证并启用的发件号码（例如已购买的 US/CA 电话号码或已批准的短代码）。该号码需满足：

已在 Amazon Pinpoint 控制台 → SMS and voice → Phone numbers 中完成购买与验证；
所在区域与 SNS Client 初始化区域一致；
具备 SMS 发送权限（默认具备，但需确保未被策略限制）。

const input = {
  PhoneNumber: "+16045181234",      // 目标手机号（E.164 格式）
  Message: "test message",
  OriginationNumber: "+12065551234" // ✅ 必填：你的已验证发件号码
};

⚠️ 注意：OriginationNumber 是 SNS Publish API 的标准字段（非 Pinpoint 专属），文档见 SNS PublishInput。

2. 显式声明 region

SNS 是区域化服务，且 SMS 功能在不同区域支持程度不同。us-east-1 是唯一支持原生 SMS 发送（无需 Pinpoint）的区域（其他区域如 us-west-2 需通过 Pinpoint）。若未指定 region，SDK 可能使用默认区域（如 us-east-1），但显式声明可杜绝歧义：

const client = new SNSClient({
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY!,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!
  },
  region: "us-east-1" // ✅ 强烈建议显式设置
});

3. 权限策略补充说明

你当前的 IAM 策略（仅允许 sns:Publish）基本足够，但为生产环境建议增强：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:us-east-1:YOUR_ACCOUNT_ID:*"
    }
  ]
}

? 提示：资源 ARN 限制到具体 Topic 或通配符 * 更安全；避免使用 "Resource": "*"（过度宽松）。

✅ 完整可运行示例

import { PublishCommand, SNSClient } from '@aws-sdk/client-sns';

export const sendSms = async () => {
  try {
    const client = new SNSClient({
      credentials: {
        accessKeyId: process.env.AWS_ACCESS_KEY!,
        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!
      },
      region: 'us-east-1' // 必须与 OriginationNumber 所在区域一致
    });

    const input = {
      PhoneNumber: '+16045181234',
      Message: 'Hello from AWS SDK v3!',
      OriginationNumber: '+12065551234' // 替换为你的已验证号码
    };

    const command = new PublishCommand(input);
    const response = await client.send(command);

    console.log('✅ SMS sent successfully:', response.MessageId);
    return response;
  } catch (error: any) {
    console.error('❌ SMS failed:', error.message);
    throw error;
  }
};

? 注意事项与调试建议

号码格式：PhoneNumber 和 OriginationNumber 均须为 E.164 格式（如 +12065551234），不可带空格、括号或破折号；
账户状态：检查 AWS 账户是否处于 SMS sandbox 模式。沙箱中仅能向已验证的手机号发送（需在 SNS 控制台手动添加）；
费用与配额：首次使用需提升 SMS 发送配额并确认账户已启用付费功能；
日志追踪：启用 CloudWatch Logs for SNS（需配置 Delivery Status Logging）可查看每条消息的实际投递状态（成功/失败/拒收原因）。