先确认工作流是否启动
打开拉取请求的 Checks 标签,记下必需检查名称,再查找最新提交对应的工作流运行。如果有运行记录,检查任务是在等待运行器、等待审批,还是在具体步骤失败。如果没有运行记录,先检查触发条件和提交消息,再考虑调整运行器。
把变更文件与触发条件对照
例如,一个 iOS 仓库忽略 docs/** 下的变更,却要求 iOS 测试工作流通过后才能合并。只修改 docs/setup.md 的拉取请求可能跳过整个工作流,留下等待中的必需检查。如果另一个请求同时修改应用代码,在分支和事件条件匹配时应触发工作流。也要核对目标分支。GitHub 文档指出,路径过滤、分支过滤和提交消息中的跳过指令都可能让必需检查停在等待状态。
让必需检查始终报告结果
如果相关拉取请求必须有明确结果,就让这些请求启动工作流,再在工作流内部判断是否需要运行耗时测试。可以由前置任务分类变更,再由始终运行的最终检查报告测试是有意跳过、成功还是失败。保持最终检查名称稳定,并确保它如实报告必需测试的失败。避免让分支保护依赖在文档变更时消失的任务。
用三种拉取请求验证
分别提交仅修改文档、应用测试通过、应用测试受控失败三种变更。第一种应报告有意跳过,第二种应真正运行测试并通过,第三种应继续阻止合并。如果文档请求仍然等待,请对比仓库要求的检查名称和工作流实际报告的名称。
把必需检查名称与实际运行核对
从合并区域复制正在等待的准确检查名称,再查看同一提交的 Actions。如果没有工作流运行,检查路径、分支筛选及提交信息。如果有运行,查看作业到底被跳过、失败,还是以另一个名称完成。这样能区分没有报告结果与测试真实失败。
例如仓库要求 unit-tests,但只有 src 改动才触发工作流。只改文档的拉取请求可能一直等不到这个名称。手动运行其他工作流,即使全绿,也可能无法满足该拉取请求的要求。应一起核对触发条件和必需检查设计,让合适的拉取请求事件能够报告预期结果。
在授权测试分支分别验证只改文档、源码测试通过和源码测试故意失败三个案例。第一种要有明确结果,第二种应通过,第三种必须仍然阻止合并。逐次核对检查名称及关联提交,并保留这三组回归测试。