如何解决Lambda调用AWS Pinpoint发送APNS Sandbox推送无通知问题？

常见故障原因定位 #

• 异步流程未正确等待是首要排查点：当前代码中sendTestNotification虽然标注了async属性，但内部调用pinpoint.sendMessages时传入了回调函数。AWS SDK v2在传入回调的调用模式下不会返回Promise，这个调用属于发后即忘的状态——await sendTestNotification()根本不会等待Pinpoint API请求真正发送完成、也不会等待回调逻辑执行，Lambda进程很可能在网络请求还没走完的阶段就被回收，自然不会触发推送投递。你感知到的“无报错、流程走完”，本质是Lambda自己的执行流程跑完了，和Pinpoint API的调用结果完全无关。
• 未校验接口返回的业务级投递结果：哪怕Pinpoint API调用走完，返回了HTTP 200的成功响应，也不代表推送真的投递成功。接口返回的MessageResponse.Result字段中，会记录每个目标地址的实际投递状态、失败原因——比如Token无效、APNS证书校验失败、通道配置不匹配这类问题，都会以业务结果的形式返回，不会抛出调用层的报错。你当前的日志只笼统打印错误和返回对象，根本没拿到这些关键信息。

逐项核对配置一致性 #

• Token值匹配校验：逐字符对比代码里硬编码的设备Token和控制台测试时用的Token，排除复制过程中带入的空格、换行、大小写偏差问题。APNS沙箱通道对Token格式校验非常严格，哪怕一个字符的偏差，Pinpoint都会静默标记投递失败，不会返回调用层的错误。
• 部署区域核对：确认Lambda中配置的us-east-1区域，和你创建Pinpoint应用、配置APNS沙箱通道证书的区域完全一致。如果区域不匹配，Pinpoint在对应区域下找不到对应的通道配置，就会直接标记消息投递失败，不会抛出配置类异常。
• 权限有效性验证：你提到已经为Lambda角色配置了Pinpoint全量权限，结合之前的异步流程问题，你之前根本没拿到真实的API返回，自然感知不到权限类报错。如果存在权限不足的问题，Pinpoint接口会抛出明确的AccessDeniedException，只要把流程改成真正等待API返回，就能直接在日志里看到相关问题。

修正后的参考实现 #

const AWS = require('aws-sdk');
// 初始化阶段固定配置区域，避免运行时重复配置
AWS.config.update({ region: 'us-east-1' });
const pinpoint = new AWS.Pinpoint();

async function sendTestNotification() {
    console.log("CALLED SEND TEST")
    const title = "Test Message"
    const message = "This is a message from Pinpoint dynamically delivered via code"
    const applicationId = '<替换为你的Pinpoint应用ID>'
    const token = '<替换为你的设备Token>'
    const messageRequest = {
      'Addresses': {
        [token]: {
          'ChannelType' : 'APNS_SANDBOX'
        }
      },
      'MessageConfiguration': {
        'APNSMessage': {
          'Action': 'OPEN_APP',
          'Body': message,
          'Priority': 'normal',
          'SilentPush': false,
          'Title': title,
          'TimeToLive': 30
          }
      }
    };
    
    const params = {
      "ApplicationId": applicationId,
      "MessageRequest": messageRequest
    }
    
    // 直接await Promise形式的SDK调用，确保流程等待API返回
    try {
        const sendResult = await pinpoint.sendMessages(params).promise();
        // 完整打印投递结果，重点查看每个地址的状态和失败原因
        console.log('Pinpoint投递结果:', JSON.stringify(sendResult, null, 2));
    } catch (err) {
        console.error('调用Pinpoint接口报错:', err);
        throw err;
    }
}

exports.handler = async (event) => {
    console.log('running')    
    await sendTestNotification();
    return {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
};

后续排查步骤 #

• 运行修正后的代码，在CloudWatch日志中找到完整的Pinpoint返回结果，根据Result字段中的StatusMessage字段定位具体投递失败原因
• 确认日志中投递成功的记录后，可在Pinpoint控制台的消息活动页面，找到对应发送批次的记录，核对代码发送的记录是否和控制台记录匹配，排除消息路由到其他应用的问题

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