Dialogflow集成Google Calendar出现崩溃，如何定位排查具体故障？

1. 补充错误日志定位根因 #

现有代码的错误捕获分支没有打印异常信息，是无法看到报错的核心原因，先修改两处代码补全日志：

• 修改check函数内Calendar API回调的日志逻辑：

calendar.events.list({
    auth: serviceAccountAuth, 
    calendarId: calendarId,
    timeMin: beginning,
    timeMax: end,
}, (err, calendarResponse) => {
    // 新增错误打印
    console.error('Calendar API调用错误：', err);
    console.log('Calendar API返回结果：', calendarResponse);
    if (err || calendarResponse.data.items.length <= 0) {
        reject(err || new Error('theres nothing here'));
    } else {
        resolve(calendarResponse);
    }
});

• 修改checkAppointment函数的catch分支日志逻辑：

function checkAppointment (agent) {
  return check().then((value) => {
        agent.add(`yep ${value.data}`);
    }).catch((e) => {
        // 新增异常打印
        console.error('查询预约逻辑执行错误：', e);
        agent.add(`I'm sorry.`);
    });
}

修改后重新部署，触发意图后即可在Firebase Functions日志中看到具体报错内容。

2. 排查已知高概率崩溃点 #

• moment导入错误：moment库为默认导出，你当前使用的解构导入写法const {moment} = require('moment');会导致moment为undefined，调用时直接抛出异常，修改为const moment = require('moment');即可，这是最常见的崩溃原因
• 依赖缺失问题：确认package.json中已经明确声明googleapis、moment、dialogflow-fulfillment三个依赖，版本无冲突，依赖缺失会直接导致运行时崩溃
• 服务账号权限问题：确认使用的服务账号已经被添加到目标Google Calendar的共享列表，且授予了查看所有日历详情的权限，同时确认calendarId为目标日历的正确ID
• 时区匹配问题：你当前生成的timeMin、timeMax为UTC时间，若你的日历事件按非UTC时区设置，可能出现查询范围不符的情况，可调整为对应时区的时间后再传入API

3. 本地测试缩小问题范围 #

• 先将check函数单独提取到本地运行，直接调用验证是否能正常获取Calendar事件，排除API调用本身的问题
• 再通过Dialogflow自带的测试控制台发送请求，结合Firebase Functions打印的错误日志，定位具体崩溃的代码行

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