AWS Lambda调用Stripe invoices list接口偶发无报错超时挂起问题

1. 优先排查Lambda VPC网络配置问题 #

• 如果你的Lambda部署在自定义VPC中，默认无法访问公网，Stripe API属于公网服务，未配置NAT网关/NAT实例的情况下，出站请求会被静默丢弃，不会触发报错，直接挂起直到超时。偶发成功的情况大概率是部分可用区NAT配置正常、部分异常，或者你尚未完全切到自定义VPC部署。
  解决方案：
  • 给Lambda所在的私有子网配置路由规则，指向公网NAT网关，确保VPC内资源可正常访问公网
  • 如果不需要访问VPC内的私有资源，直接将Lambda切回默认无VPC模式，默认具备公网访问能力

2. 确认Stripe SDK超时配置是否实际生效 #

你代码中设置的2000ms超时未触发，大概率是旧版本Stripe Node SDK存在超时配置不生效的bug，也可能是网络重试逻辑和超时叠加，导致总耗时远超预期，还没抛出错误就被Lambda终止。
解决方案：

• 将Stripe Node SDK升级到最新稳定版
• 给异步请求增加独立的超时包装，确保一定会在Lambda超时前抛出错误，示例代码如下：

// 通用超时包装函数
const withTimeout = (promise, timeoutMs) => {
  return new Promise((resolve, reject) => {
    const timer = setTimeout(() => {
      reject(new Error(`Request timed out after ${timeoutMs}ms`));
    }, timeoutMs);
    promise.then(res => {
      clearTimeout(timer);
      resolve(res);
    }).catch(err => {
      clearTimeout(timer);
      reject(err);
    });
  });
};

// 调用Stripe时的改造代码
invoices = await withTimeout(stripe.invoices.list({
  status: 'open',
  limit: 100,
}), 5000); // 5秒超时，远小于Lambda的15秒超时阈值

3. 调整Lambda上下文配置 #

Node.js版Lambda默认会等待事件循环为空才返回结果，如果Stripe SDK底层TCP连接未主动释放，可能会出现请求已返回但进程卡住的情况，可在函数入口处增加配置关闭该逻辑：

const microservice = async (event, context, callback) => {
  context.callbackWaitsForEmptyEventLoop = false;
  // 剩余原有代码
}

4. 排查其他网络链路问题 #

• 确认Lambda安全组的出站规则允许443端口的所有出站流量，避免拦截到Stripe的HTTPS请求
• 可在调用Stripe接口前增加公网连通性测试，比如请求公共可访问的HTTPS接口，确认是所有公网请求都挂起还是仅Stripe请求异常

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