如何让GitHub Bot接收Lambda请求并自动创建Pull Request

一、前期准备 #

• 确认操作范围：明确Bot需要访问的仓库属性（个人/组织、公开/私有），以及可操作的仓库列表，后续权限配置要和范围匹配
• 梳理触发规则：提前对齐两个核心逻辑：
  1. Lambda请求的来源、鉴权方式、携带的参数格式
  2. 文件变更的触发条件（是全仓库文件变更都触发，还是仅监听指定路径下的文件）、PR的源/目标分支规则、自动生成的PR信息规则

二、GitHub 身份权限配置 #

生产环境推荐使用GitHub App实现Bot，权限粒度更可控，小范围测试可以直接用PAT简化流程：

测试场景下可以直接生成目标仓库的Personal Access Token(PAT)，勾选repo权限即可跳过GitHub App创建步骤，生产环境不推荐使用，泄露后风险较高。

• 进入GitHub的Settings > Developer settings > GitHub Apps，新建GitHub App，填写基础信息
• 权限配置：在Repository permissions项中，将Contents权限设为读写，Pull requests权限设为读写，因为是Lambda主动触发请求，不需要监听仓库事件的话可以关闭Webhook开关
• 生成凭证：创建完成后保存App ID，生成并下载Private Key，将App安装到目标仓库后获取对应的Installation ID，三个凭证用于后续调用GitHub API的鉴权

三、Lambda 服务开发 #

• 运行环境可以根据你的技术栈选择，Python推荐用PyGitHubSDK、Node.js推荐用octokitSDK调用GitHub API，省去手动封装请求的工作量
• 鉴权逻辑：首先实现GitHub App JWT生成逻辑，用Private Key和App ID生成JWT，再用JWT和Installation ID换取对应仓库的临时访问令牌，后续所有GitHub API请求都携带该令牌
• 入参校验：新增参数校验逻辑，校验Lambda请求的合法性，确认必填参数（变更文件路径、文件内容、目标仓库、分支信息等）是否完整，避免非法请求触发无效操作

四、核心PR创建逻辑开发 #

• 分支创建：拉取目标仓库最新的目标分支代码，基于该分支新建临时分支，分支名可以按照auto-pr/时间戳/变更标识的规则自动生成，避免重复
• 文件变更提交：将请求传入的变更文件内容写入到新分支的对应路径，调用Contents API提交变更，commit信息可以按预设规则生成，也支持从Lambda请求参数中传入自定义内容
• PR创建：调用Pull Request API创建PR，自动填充预设的标题、描述，也可以按需配置自动打标签、指定审核人等逻辑
• 异常处理：新增异常捕获逻辑，分支创建、文件提交、PR创建任意环节失败都要记录错误日志，返回对应错误状态码方便上游排查

五、测试上线 #

• 先使用测试仓库完成全流程验证，手动触发Lambda请求确认PR创建符合预期，没有权限、内容错误等问题
• 新增幂等判断：可以在PR描述中添加唯一的变更标识位，每次创建PR前先查询是否有相同标识的未合并PR，避免重复创建
• 上线后可按需添加成功率统计、异常告警等监控能力，方便后续迭代优化

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