本地使用SAM Local Invoke测试Lambda函数时容器无响应问题求助

我之前也碰到过一模一样的情况——云端Lambda跑的好好的，本地用SAM调用就卡着无响应。结合你的配置（异步函数、DocumentDB证书、CDK NodejsFunction打包），大概率是本地容器没法正常访问DocumentDB，或者证书加载出了问题，导致函数卡住，容器没法返回响应。给你几个针对性的排查和解决步骤：

1. 先排除业务代码的影响 #

先把和DocumentDB交互的代码注释掉，让函数返回一个最简单的结果，比如：

async export const execute = async (sqsEvent: SQSEvent): Promise<PutEventsCommandOutput> => {
  // 暂时注释掉DocumentDB相关逻辑
  return { FailedEntryCount: 0, Entries: [] } as PutEventsCommandOutput;
}

重新用CDK打包（cdk synth）后再用SAM调用，如果这次能正常返回结果，那问题肯定出在DocumentDB的网络或证书上。

2. 检查证书文件是否正确打包到asset里 #

你在CDK里配置了loader: { '.pem': 'file' }，但要确认证书文件确实被打包到了SAM挂载的asset目录里：

• 打开/path-to-my-project/my-project/cdk.out/asset.aaaaa9999999cd5a9f38e9c4e503cc9c9bdf8ccdc8f9999991b12b6161e99999这个目录，看看你的pem证书是不是在里面。
• 可以在函数里加一行日志打印证书路径：console.log('Cert path:', require.resolve('./your-cert.pem'))，然后用sam local invoke --debug调用，即使还是无响应，debug日志里可能会显示容器内部的输出，能帮你确认路径对不对。

3. 让SAM容器用宿主机的网络访问DocumentDB #

如果你的DocumentDB在VPC里，本地SAM容器默认是隔离的网络，没法直接访问。可以给SAM命令加--docker-network host参数，让容器用宿主机的网络（前提是你本地已经通过VPN或者其他方式连到了VPC）：

sam local invoke --region us-east-1 --env-vars .env.json -t ./cdk.out/my-project.template.json -e events/example.event.json --docker-network host MyLambdaXXXXXXXX

这样容器就能复用你本地的网络连接，访问到VPC里的DocumentDB了。

4. 给异步函数加错误捕获 #

你的函数是异步的，如果DocumentDB调用抛出异常但没被捕获，可能会导致函数静默失败，容器没法返回响应。给函数加个try-catch：

async export const execute = async (sqsEvent: SQSEvent): Promise<PutEventsCommandOutput> => {
  try {
    await someAsyncStuffWithDocumentDB();
    return { FailedEntryCount: 0, Entries: [] } as PutEventsCommandOutput;
  } catch (err) {
    console.error('Function failed:', err);
    throw err; // 抛出异常让Lambda运行时处理，返回错误响应
  }
}

再用--debug模式调用，就能看到具体的错误信息了。

5. 升级SAM CLI版本 #

你用的是rapid-1.46.0版本，这个版本确实存在一些容器交互的已知问题，升级到最新版大概率能解决一些奇怪的bug：

pip install --upgrade aws-sam-cli

升级完重新打包测试试试。

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