如何查看GitHub发送给集成应用的内容？Checkly集成故障排查

1. 明确基础交互逻辑 #

• 部署触发测试的场景下，是GitHub主动向Checkly推送deploy事件，仅当你开启了测试代码/配置同步到Checkly的功能时，Checkly才会主动轮询拉取GitHub仓库内容
• 变量未定义大概率是deploy事件的payload字段缺失，先确认你要的变量属于GitHub deploy事件的标准字段，非标准字段需要额外配置才能传递

2. 排查GitHub侧事件发送情况 #

• 进入对应GitHub仓库的设置→Webhooks，找到Checkly对应的webhook条目，点击即可查看所有近期发送的事件记录，包含每次请求的header、完整payload、返回状态码
• 找到对应deploy动作触发的事件记录，直接查看payload里是否存在你要的变量，若此处无对应字段，说明是GitHub侧未生成对应内容，和Checkly无关
• 若payload里有对应字段，去Checkly集成配置页检查变量引用的写法是否正确，注意变量名大小写敏感

3. 排查Checkly侧事件接收情况 #

• 进入Checkly控制台的设置→Integrations→GitHub，找到对应仓库的集成条目，查看事件接收日志，可确认每次GitHub推送的事件是否被正确解析、提取到的变量值是什么
• 也可直接打开异常测试的运行结果详情页，查看触发该次测试的上下文参数，确认变量是否在触发阶段就未被正确传入

4. 快速定位问题方法 #

• 可在测试脚本中添加打印所有环境变量的代码：console.log(process.env)，运行测试后查看输出结果里是否存在目标变量，排除代码里变量引用写错的问题
• 也可以手动构造包含目标变量的deploy事件，用curl模拟推送到Checkly的webhook地址，确认Checkly侧的解析逻辑是否正常

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