AWS SNS创建Platform Endpoint失败，求技术协助排查代码问题

让我们一步步定位问题，先从几个常见的关键点入手：

1. 捕获具体AWS异常，明确错误原因 #

你的代码只抛出了笼统的Exception，无法获取AWS返回的精准错误信息（比如权限不足、ARN无效、设备令牌格式错误，或者端点已存在）。先修改代码，捕获AmazonSimpleNotificationServiceException，这样能直接拿到错误码和详情：

public async Task<string> CreatePushEndpoint(string deviceToken, string platformApplicationArn)
{
    // 更严谨的参数校验，明确指出哪个参数有问题
    if (string.IsNullOrEmpty(deviceToken)) 
        throw new ArgumentException("Device token cannot be null or empty.", nameof(deviceToken));
    if (string.IsNullOrEmpty(platformApplicationArn)) 
        throw new ArgumentException("Platform application ARN cannot be null or empty.", nameof(platformApplicationArn));

    try
    {
        var request = new CreatePlatformEndpointRequest() 
        { 
            PlatformApplicationArn = platformApplicationArn, 
            Token = deviceToken 
        };
        var response = await _client.CreatePlatformEndpointAsync(request);
        return response.EndpointArn;
    }
    catch (AmazonSimpleNotificationServiceException snsEx)
    {
        // 处理最常见的「端点已存在」场景
        if (snsEx.ErrorCode == "InvalidParameter" && snsEx.Message.Contains("Endpoint already exists"))
        {
            // AWS会在错误消息里返回已存在的EndpointArn，我们提取出来复用
            var existingArn = ExtractExistingEndpointArn(snsEx.Message);
            if (!string.IsNullOrEmpty(existingArn))
            {
                return existingArn;
            }
        }
        // 把具体错误信息包装后抛出，方便调试
        throw new InvalidOperationException($"Failed to create SNS endpoint: {snsEx.Message} (Error Code: {snsEx.ErrorCode})", snsEx);
    }
    catch (Exception ex)
    {
        // 处理非AWS相关的异常（比如网络问题）
        throw new InvalidOperationException("Unexpected error creating SNS endpoint", ex);
    }
}

// 辅助方法：从AWS错误消息中提取已存在的Endpoint ARN
private string ExtractExistingEndpointArn(string errorMessage)
{
    // 错误消息格式示例："InvalidParameter: Invalid token ... Endpoint already exists arn:aws:sns:us-east-1:123456789012:endpoint/GCM/MyApp/abc123..."
    var arnStartIndex = errorMessage.IndexOf("arn:aws:sns:");
    if (arnStartIndex >= 0)
    {
        var arnEndIndex = errorMessage.IndexOf(" ", arnStartIndex);
        if (arnEndIndex < 0) arnEndIndex = errorMessage.Length;
        return errorMessage.Substring(arnStartIndex, arnEndIndex - arnStartIndex);
    }
    return null;
}

2. 验证AWS客户端初始化是否正确 #

确保_client实例是用正确的区域和有效凭证初始化的：

• Platform Application ARN和区域绑定，比如你的ARN是arn:aws:sns:us-east-1:...，客户端就必须用RegionEndpoint.USEast1初始化。
• 如果在AWS服务（如EC2、Lambda）上运行，确认IAM角色有SNS操作权限；如果是本地运行，确保AWS凭证（Access Key/Secret Key）配置正确，且有权限操作目标SNS资源。

示例客户端初始化代码：

// 本地开发用凭证文件或环境变量
var snsClient = new AmazonSimpleNotificationServiceClient(RegionEndpoint.USEast1);
// AWS服务上运行时，使用默认IAM角色
var snsClient = new AmazonSimpleNotificationServiceClient();

3. 检查参数有效性 #

• PlatformApplicationArn：确认格式正确（示例：arn:aws:sns:区域:账号ID:app/平台类型/应用名称），且属于当前AWS账号，区域和客户端一致。
• DeviceToken：确保是对应推送平台的有效令牌：
  • iOS APNs令牌是64位十六进制字符串，无空格
  • Android FCM令牌是长度40-200之间的字符串
  • 令牌未过期或被推送平台吊销

4. 确认IAM权限 #

运行代码的IAM实体（用户/角色）必须拥有sns:CreatePlatformEndpoint权限，且资源范围包含目标PlatformApplicationArn。示例IAM策略：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "sns:CreatePlatformEndpoint",
            "Resource": "arn:aws:sns:us-east-1:123456789012:app/GCM/YourPushApp"
        }
    ]
}

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