配置Spring Boot对接AWS SNS HTTP端点报TopicArn无效参数异常

调用SDK创建SNS到Web应用的HTTP/HTTPS订阅时，抛出如下异常：

com.amazonaws.services.sns.model.InvalidParameterException: 
Invalid parameter: TopicArn (Service: AmazonSNS; Status 
Code: 400; Error Code: InvalidParameter; 
Request ID: 151fe19b-c8e3-55ee-ba38-bab3e65af5e9; Proxy: null)

按以下优先级逐一排查即可解决：

• 核对TopicArn值的准确性
  标准SNS主题ARN格式为arn:aws:sns:<主题所在区域码>:<AWS账号ID>:<主题名称>，不要手动拼写该值，直接登录AWS控制台进入对应SNS主题的详情页，复制页面展示的完整ARN，替换代码、配置文件中存储的TopicArn值。重点排查以下常见拼写问题：
  • 区域码书写错误，比如漏写横杠、区域码和主题实际部署区域不匹配
  • 账号ID位数错误、填错其他账号的ID
  • 主题名称大小写错误、首尾带不可见空格/换行符，配置文件注入时值被多余引号包裹
• 核对SNS客户端的区域配置
  就算TopicArn值完全正确，如果初始化AmazonSNS客户端时指定的区域和主题实际部署的区域不一致，SNS服务端会判定当前区域下不存在对应ARN的主题，直接返回参数非法错误。可以在调用订阅接口前打印客户端生效的区域配置，和控制台主题的区域做比对，保证两者完全一致。
• 核对IAM权限配置
  权限配置错误不一定返回403权限不足报错：如果发起订阅操作的AK/SK对应的IAM身份（用户、角色）没有目标主题的sns:Subscribe权限，或是主题的资源策略拒绝了当前身份的访问，也可能返回TopicArn参数非法的报错。排查时可以先给当前操作身份授予目标主题的订阅权限、调整主题资源策略允许当前身份访问，测试订阅是否正常，验证通过后再收敛到最小权限即可。
• 核对参数传递逻辑
  调用subscribe接口时确认参数位置正确：第一个参数传入TopicArn，第二个参数传入协议类型（HTTP端点填http、HTTPS端点填https），第三个参数传入你的Web应用接收SNS消息的端点地址，不要把参数顺序搞混。建议在实际发起请求前打日志打印三个入参的实际值，确认没有传错位、没有带多余字符。

可参考以下正确的代码示例：

// 初始化SNS客户端，区域必须和主题所在区域一致
AmazonSNS snsClient = AmazonSNSClient.builder()
        .withRegion(Regions.AP_EAST_1) // 替换为你的主题实际所在区域
        .withCredentials(new AWSStaticCredentialsProvider(
                new BasicAWSCredentials("你的访问密钥AK", "你的访问密钥SK")
        ))
        .build();

// 构造订阅请求，参数顺序不要错
String topicArn = "从SNS控制台复制的完整主题ARN";
String callbackEndpoint = "https://你的Web应用域名/sns/receive"; // 替换为你的实际接收端点
SubscribeRequest subRequest = new SubscribeRequest(
        topicArn,
        "https", // 端点是HTTP就填"http"
        callbackEndpoint
);

// 发起订阅请求
snsClient.subscribe(subRequest);

注：报错信息中Proxy: null说明当前SDK未配置HTTP代理，可排除代理篡改请求参数的问题。

内容的提问来源于stack exchange，提问作者BERGUIGA Mohamed Amine