NodeJS使用AWS SNS新版SDK发送短信至指定手机号失败求助

问题原因 #

你遇到的InvalidParameter错误，本质是服务端未识别到合法的PhoneNumber参数（而非新版SDK不支持直接发手机号），进而触发了默认的TopicArn/TargetArn必填提示。常见诱因包括手机号格式错误、所选AWS区域不支持SMS功能、账号未完成SMS配置或权限不足。

解决方案步骤 #

1. 严格遵循E.164手机号格式 #

必须使用标准E.164格式：

• 以+开头
• 后跟国家代码（如中国为86，美国为1）
• 手机号部分无任何非数字字符（空格、括号、连字符都要去掉）
  示例：中国手机号+8613800138000，美国手机号+12065551234

2. 选择支持SMS的AWS区域 #

并非所有AWS区域都支持SNS短信服务，推荐使用以下常用区域：

• us-east-1（弗吉尼亚北部）
• ap-southeast-1（新加坡）
• eu-west-1（爱尔兰）
• us-west-2（俄勒冈）

3. 完成AWS账号SMS初始配置 #

• 登录AWS控制台，进入SNS服务，左侧菜单选择Mobile->Text messaging (SMS)
• 检查账号是否完成SMS验证，无发送限制（新账号默认发送额度极低，可能需要申请提升权限）
• 部分国家/地区需额外完成合规注册（如发送者ID审核）

4. 修正代码（含格式校验与可选配置） #

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

// 验证E.164格式手机号
function validateE164PhoneNumber(phoneNumber) {
  const e164Regex = /^\+[1-9]\d{1,14}$/;
  return e164Regex.test(phoneNumber);
}

async function sendMessage(message, phoneNumber) {
  // 前置格式校验
  if (!validateE164PhoneNumber(phoneNumber)) {
    console.error("手机号格式错误，需遵循E.164标准（例如：+8613800138000）");
    return;
  }

  const snsClient = new SNSClient({
    credentials: fromEnv(),
    region: process.env.AWS_REGION || "us-east-1", // 确保区域支持SMS
  });

  const params = {
    Message: message,
    PhoneNumber: phoneNumber,
    // 可选：指定SMS类型（Transactional为事务性短信，Promotional为营销短信，部分区域要求）
    MessageAttributes: {
      'AWS.SNS.SMS.SMSType': {
        DataType: 'String',
        StringValue: 'Transactional'
      }
    }
  };

  try {
    const command = new PublishCommand(params);
    const data = await snsClient.send(command);
    console.log("短信发送成功", data);
    return data;
  } catch (err) {
    console.error("短信发送失败", err);
    throw err;
  }
}

module.exports = { sendMessage };

额外排查点 #

• 确认IAM凭证拥有sns:Publish权限，检查用户政策是否包含该操作
• 尝试在AWS控制台手动发送测试短信，验证账号与区域的可用性
• 若目标国家/地区有特殊合规要求，需完成对应配置（如发送者ID注册）

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