确认具体作业与事件
记录事件、触发身份、仓库及作业环境,再对照密钥实际配置位置。仓库、组织、环境的访问边界不同,可复用工作流也需要按接口传入密钥。
例如仓库内构建正常,来自 fork 的拉取请求却在上传时失败,先查事件限制。除 GITHUB_TOKEN 的例外外,来自 fork 的工作流不会收到密钥。纯测试路径可以考虑跳过上传,让需要凭据的操作走已批准路径。
只测是否存在,不输出内容
在小型诊断步骤中把密钥映射到环境变量,只判断是否非空,并输出“凭据可用”或“凭据不可用”这样的固定消息。不要输出值、片段或编码版本来证明已收到。
如果授权内部运行也为空,核对拼写和环境选择。内部可用而 fork 不可用,可能正是预期限制。环境密钥还要确认作业引用了对应环境并满足规则。
分别验证授权与受限路径
用访问最小的无害操作验证集成。确认授权路径收到变量,受限路径仍无权访问。仓库同时接受可信与不可信贡献时,可把测试和需要凭据的部署分开。
最后移除临时诊断,让实际错误提示指出哪个集成不可用,以及应走哪个工作流路径。错误报告也不应包含密钥。fork 上传案例为演示,本文依据 GitHub 的密钥文档。