如何排查Node.js迁移后Amazon Lambda Alexa智能家居语音请求故障？

1. 先解决CloudWatch无日志输出的问题 #

• 检查Lambda执行角色权限：确认角色拥有logs:CreateLogGroup、logs:CreateLogStream、logs:PutLogEvents这三个CloudWatch日志相关权限，Node.js版本升级后若调整过角色策略，可能漏掉这些权限。
• 验证Lambda入口导出：确保代码中exports.handler导出正确，Node.js 20对模块规范更严格——如果用ES模块，需在package.json中设置"type": "module"；若用CommonJS，必须用module.exports而非ES模块的export语法。
• 本地运行测试：用Node.js本地环境或AWS SAM CLI，传入模拟的Alexa智能家请求Payload执行代码，检查是否有未捕获异常（比如未处理的Promise拒绝），Node.js 20会直接终止这类进程，导致日志无法上传到CloudWatch。

2. 排查Alexa响应格式不规范问题 #

• 对齐最新API规范：升级SDK后，Alexa智能家响应的JSON结构可能有变更，需确保返回的event、header、payload字段完全符合最新规范，尤其是错误响应的格式——格式不符会触发Alexa默认错误提示。
• 全局捕获异常并返回规范响应：在Lambda handler外层包裹try-catch，捕获异常后打印日志，并返回符合Alexa要求的错误响应，示例代码：

  exports.handler = async (event) => {
    try {
      // 原有业务逻辑
      return validResponse;
    } catch (error) {
      console.error('Lambda执行错误:', error.stack);
      return {
        event: {
          header: {
            namespace: 'Alexa',
            name: 'ErrorResponse',
            messageId: event.event.header.messageId,
            payloadVersion: '3'
          },
          payload: {
            type: 'INTERNAL_ERROR',
            message: error.message
          }
        }
      };
    }
  };
  

• 用开发者控制台校验响应：在Alexa Developer Console的「测试」页发送模拟请求，控制台会直接提示响应格式错误的具体位置，快速定位问题。

3. 检查依赖兼容性与冲突 #

• 确认依赖版本适配Node.js 20：安装ask-sdk、actions-on-google等依赖的最新稳定版，确保这些版本明确支持Node.js 20；另外注意Node.js 20运行时不再内置旧版aws-sdk，若代码中用了旧版AWS服务调用，需切换到@aws-sdk/client-*系列新SDK。
• 排查依赖冲突：执行npm ls查看依赖树，确认是否存在同一包的多版本共存情况，这类冲突可能导致运行时异常。

4. 验证语音请求的路由逻辑 #

• 核对请求类型处理：确认代码对Alexa各类请求（如DiscoveryRequest、TurnOnRequest）的路由逻辑正确，升级SDK后请求的namespace、name字段可能有变更，导致请求无法被正确分发处理。
• 用真实请求测试：从Alexa Developer Console的「测试」页面复制真实用户请求的Payload，导入Lambda测试事件中执行，直观查看代码处理流程与日志输出。

内容的提问来源于stack exchange，提问作者developer-ccei-pool