如何用Node.js通过AWS SNS向未订阅用户发送含自定义URL的欢迎短信

前置准备 #

• 确保你的AWS账号拥有SNS服务的sns:Publish权限，建议通过IAM用户配置最小权限（避免使用根账号）。
• 配置AWS凭证：可通过本地~/.aws/credentials文件、环境变量（AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY），或是在AWS云服务（如ECS/EKS）中使用IAM角色自动获取凭证。
• 安装AWS SDK for JavaScript V3（推荐模块化版本）：

  npm install @aws-sdk/client-sns
  

核心实现代码 #

直接传入用户手机号和自定义URL即可完成无需订阅的短信发送，完整逻辑如下：

const { SNSClient, PublishCommand } = require("@aws-sdk/client-sns");

// 初始化SNS客户端，替换为你的AWS区域（如cn-north-1、us-east-1）
const snsClient = new SNSClient({ region: "us-east-1" });

async function sendWelcomeSms(targetPhone, setupUrl) {
  // 构造短信内容，注意控制字符长度：中文单条限70字，英文限160字符
  const welcomeMsg = `欢迎加入！点击完成账号设置：${setupUrl}。如有问题请联系客服。`;

  const publishParams = {
    Message: welcomeMsg,
    // 手机号必须带国际区号，例如+86138xxxxxxx
    PhoneNumber: targetPhone,
    MessageAttributes: {
      // 设置为事务性短信，提升送达率（促销类场景用Promotional）
      "AWS.SNS.SMS.SMSType": {
        DataType: "String",
        StringValue: "Transactional"
      }
    }
  };

  try {
    const response = await snsClient.send(new PublishCommand(publishParams));
    console.log(`短信发送成功，消息ID：${response.MessageId}`);
    return response;
  } catch (error) {
    console.error("短信发送失败：", error);
    throw error;
  }
}

// 调用示例：替换为实际手机号和自定义URL
sendWelcomeSms("+8613800138000", "https://yourapp.com/setup?user=456")
  .then(() => console.log("欢迎短信已发出"))
  .catch(err => console.error("发送异常：", err));

关键注意事项 #

• 手机号格式：必须以国际区号开头（如+86代表中国大陆），否则SNS会直接拒绝请求。
• 内容优化：若自定义URL较长，建议使用短链接压缩（可自行搭建短链服务），避免短信因过长被拆分导致成本增加或阅读体验下降。
• 权限安全：给IAM用户仅配置sns:Publish权限，不要赋予多余权限，降低账号风险。
• 短信类型选择：Transactional适用于必要通知（如欢迎、验证码），送达率更高；Promotional用于广告促销内容，可能被运营商拦截，按需选择即可。
• 测试验证：先使用个人手机号测试，确认能正常接收后再投入生产环境。

内容的提问来源于stack exchange，提问作者sharans singh