本文详解使用 @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）可查看每条消息的实际投递状态（成功/失败/拒收原因）。
遵循以上配置后，MessageId 将真实对应一条可送达的短信。切记：SNS 的“成功响应”仅代表消息已进入 AWS 处理队列，最终送达依赖 OriginationNumber 合规性与账户配置完整性。
