Google Triage Party项目调试指南

前言

Google Triage Party是一个用于自动化问题分类和管理的工具，它能帮助开发团队高效处理大量的问题和拉取请求。本文将详细介绍该项目的调试方法和技巧，帮助开发者在遇到问题时快速定位和解决。

服务器调试

日志级别设置

服务器端提供了多级日志输出，通过-v=<level>参数可以控制日志详细程度：

1. 基础级别（-v=1）：记录关键操作日志，包括缓存未命中等重要事件
2. 详细级别（-v=2）：输出更多调试信息，适合解决大部分匹配问题
3. 最高级别（-v=3）：输出所有细节日志，通常信息量过大，仅在特殊情况下使用

建议从-v=1开始调试，根据需要逐步提高日志级别。

测试工具使用

专用测试工具

项目内置了一个独立的测试工具tester，专门用于针对特定规则和问题进行精准调试。

典型使用场景

假设我们需要调试为什么拉取请求#4126被列入了"pr-reviewable"规则中，可以使用如下命令：

go run cmd/tester/main.go \
  --github-token-file ~/.github-personal-read \
  --config config/examples/skaffold.yaml \
  --rule pr-reviewable \
  -v=3 \
  --num 4126

输出解析

测试工具会输出详细的JSON格式数据，包括：

1. 问题/PR的基本信息
2. 相关评论数据
3. 时间线事件
4. 匹配过程中的中间状态

例如，从"debug comments: null"这样的输出可以判断评论数据是否被正确获取。

特定问题调试

在代码中添加针对特定问题的调试输出时，可以使用如下模式：

if h.debug[pr.GetNumber()] {
    klog.Infof("debug response: %+v", formatStruct(resp))
}

这种方法可以避免日志泛滥，只关注特定问题的调试信息。

缓存管理

临时禁用持久化缓存

在调试过程中，缓存可能会干扰问题的重现和分析。可以通过以下参数临时禁用持久化缓存：

--persist-backend=memory

这个参数对服务器和测试工具都有效，会将缓存存储在内存中而非持久化存储。

原始API请求

直接调用GitHub API

有时需要绕过工具直接验证GitHub API的返回结果，可以使用curl等工具直接发起请求：

curl -H "Authorization: token <token>" \
  https://api.github.com/repos/<owner>/<repo>/pulls/<pr_number>/comments

这种方法可以帮助确认问题是出在工具处理逻辑还是API返回数据本身。

调试技巧总结

1. 从低日志级别开始，逐步提高
2. 使用测试工具精准定位特定规则和问题
3. 必要时禁用缓存排除干扰
4. 直接验证API返回数据
5. 关注关键日志中的null或异常值提示

通过以上方法，可以系统性地排查和解决Google Triage Party使用过程中遇到的各种问题。