如何在 Amazon SNS 中批量订阅多个手机号到同一主题

本文详解如何使用 AWS SDK for PHP 批量将多个手机号（SMS 端点）订阅至同一 SNS 主题，通过循环调用 subscribe() 方法实现高效、可控的批量注册，并附完整可运行代码与关键注意事项。

本文详解如何使用 aws sdk for php 批量将多个手机号（sms 端点）订阅至同一 sns 主题，通过循环调用 `subscribe()` 方法实现高效、可控的批量注册，并附完整可运行代码与关键注意事项。

在 amazon SNS 中，单次 subscribe() 调用仅支持一个端点（如一个手机号），无法原生批量提交多个 SMS 订阅请求。但实际业务中（例如向运营团队、通知组或客户群发送统一告警/营销短信），常需将数十甚至上百个手机号快速加入同一主题。此时，最直接、可靠且符合 AWS 最佳实践的方式是：将手机号组织为数组，结合 foreach 循环逐个调用 subscribe() —— 既复用官方 SDK 的健壮逻辑，又避免引入复杂异步协调或自定义批处理层。

以下是优化后的完整 PHP 示例代码，已移除冗余注释片段、增强可读性，并添加关键说明：

<?php require 'vendor/autoload.php';  use AwsSnsSnsClient; use AwsExceptionAwsException;  // 初始化 SNS 客户端（建议使用 IAM 角色或环境变量管理凭证，而非硬编码 profile） $snsClient = new SnsClient([     'region'  => 'us-east-1',      // 请替换为您的主题所在区域     'version' => '2010-03-31',     // 推荐：通过环境变量或 IAM 角色认证，避免 profile 配置     // 'credentials' => [     //     'key'    => 'YOUR_ACCESS_KEY',     //     'secret' => 'YOUR_SECRET_KEY',     // ], ]);  $protocol = 'sms'; $topicArn = 'arn:aws:sns:us-east-1:111122223333:MyTopic'; // 替换为您的真实 Topic ARN  // ✅ 批量手机号列表：确保格式为 E.164 标准（含国家代码，无空格/横线） $phoneNumbers = [     '+1XXX5550100',     '+2XXX5550100',     '+3XXX5550100',     // 可继续追加更多号码... ];  echo "开始批量订阅 {$topicArn} 主题...n"; $successCount = 0; $errors = [];  foreach ($phoneNumbers as $index => $phoneNumber) {     try {         $result = $snsClient->subscribe([             'Protocol'             => $protocol,             'Endpoint'             => $phoneNumber,             'TopicArn'             => $topicArn,             'ReturnSubscriptionArn' => true, // 强烈建议启用，便于后续管理         ]);          $subscriptionArn = $result['SubscriptionArn'] ?? 'pending confirmation';         echo "[✓] {$phoneNumber} → {$subscriptionArn}n";         $successCount++;          // ⚠️ AWS 建议：每秒不超过 10 次订阅请求，避免限流         // 如需处理大量号码（>50），可在此处添加 usleep(100000) 实现轻量节流         // usleep(100000); // 暂停 100ms      } catch (AwsException $e) {         $errorCode = $e->getAwsErrorCode() ?: 'Unknown';         $errorMessage = $e->getMessage();         $errors[] = "{$phoneNumber}: [{$errorCode}] {$errorMessage}";         error_log("[SNS Subscribe Error] {$phoneNumber} - {$errorCode}: {$errorMessage}");     } }  // ? 执行摘要 echo "n=== 批量订阅完成 ===n"; echo "成功订阅: {$successCount}/" . count($phoneNumbers) . "n"; if (!empty($errors)) {     echo "失败详情:n" . implode("n", $errors) . "n"; }

关键注意事项：

• E.164 格式强制要求：所有手机号必须以 + 开头，后接国家代码及本地号码（如 +8613800138000），否则 SNS 将返回 InvalidParameter 错误；
• 地域一致性：$topicArn 中的区域（如 us-east-1）必须与 $snsClient 初始化时指定的 region 完全一致；
• 权限配置：执行账号需具备 sns:Subscribe 权限，且策略中明确允许目标 Topic ARN；
• 速率限制：SNS 默认限制每秒最多 10 次 Subscribe 请求。若需处理数百号码，建议添加 usleep() 节流，或改用 SQS + Lambda 异步队列模式；
• 确认机制：SMS 订阅默认为“待确认”状态（PendingConfirmation），用户需回复 YES 至 SNS 短信网关方可激活；可通过 sns:ConfirmSubscription API 或控制台手动确认（不适用于 SMS）；
• 错误处理增强：生产环境应捕获具体错误码（如 AuthorizationError、Throttling、InvalidParameter），并设计重试或告警机制。

该方案简洁、稳定、完全兼容 AWS 官方 SDK，是当前批量管理 SMS 订阅最推荐的工程实践。