Service Hook（代码推送）事件触发后，如何获取推送文件引用？

我之前也碰到过一模一样的困扰！其实不同平台的Service Hook在事件触发时返回的Payload结构差异很大，你可以从这几个方向入手排查和解决：

1. 先抓取并分析当前Service Hook的完整Payload #

首先你得搞清楚当前这个Hook返回的内容到底有什么。可以用本地工具（比如ngrok把本地服务暴露到公网，或者直接查看平台提供的Hook日志功能），把Code pushed事件触发时的请求Body完整打出来。

对比一下GitHub Hooks的结构——GitHub的Payload里，commits数组下每个提交对象都会带着added、removed、modified三个字段，直接列出对应文件。但有些平台的Service Hook可能把文件列表藏在别的层级，比如push节点下的changes数组，或者需要你遍历所有关联的commit对象去提取细节。

2. 检查Hook的配置选项 #

很多平台的Code pushed事件默认只返回基础的推送元数据（比如仓库地址、推送者、commit SHA），如果要获取文件变更，需要在Hook的设置页面手动开启对应的选项。比如有些平台会有“包含提交详情”“返回文件变更列表”这类勾选框，你去配置页找找看，说不定开启之后就能拿到文件引用了。

3. 用平台API补全文件信息 #

如果当前Hook的Payload里确实没有文件列表，那可以利用平台提供的API来补充查询。Payload里一般会包含仓库的唯一标识、推送的目标分支、最新的commit SHA这些关键参数，你可以用这些参数调用“获取提交详情”的API接口，从接口返回里提取每个commit的文件变更。

举个伪代码示例（逻辑通用，具体接口根据平台调整）：

// 假设payload里有repoId和latestCommitSha
async function getPushedFiles(repoId, latestCommitSha) {
  const commitDetails = await fetch(`/api/repos/${repoId}/commits/${latestCommitSha}`);
  const files = commitDetails.files.map(file => file.path);
  // 如果是多commit推送，需要遍历所有关联的commit
  return files;
}

4. 注意多commit推送的场景 #

如果一次推送包含多个commit，记得要遍历所有关联的commit对象去收集文件，不要只取最新的那个commit的文件列表，不然会漏掉之前commit里的变更。

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