CI 流水线失败:密钥不可用
快速摘要
你的 CI 流水线失败 —— 流水线中引用的密钥或环境变量未设置。
为什么发生
密钥未添加到 CI 系统的密钥存储中
流水线中的密钥名称与 CI 配置中的名称不匹配
密钥的作用域是不同的环境或分支,在当前运行中不可用
最小示例
✗ 错误代码
# .github/workflows/deploy.yml
steps:
- name: Deploy
run: npm run deploy
env:
API_KEY: ${{ secrets.API_KEY }} # secret not configured in GitHub✓ 修复代码
# Add the secret in GitHub: Settings > Secrets and variables > Actions > New secret
# Name: API_KEY, Value: your-api-key
steps:
- name: Deploy
run: npm run deploy
env:
API_KEY: ${{ secrets.API_KEY }} # now available将 API_KEY 密钥添加到 GitHub 仓库的密钥存储使其对流水线步骤可用。
如何诊断
检查 CI 流水线错误消息中缺失的密钥或环境变量名
验证密钥以正确的名称存在于 CI 系统的密钥存储中
检查密钥在当前分支或环境作用域中的可用性
如何修复
将缺失的密钥添加到 CI 系统的密钥存储
更正流水线中的密钥名称以匹配 CI 配置
使密钥在当前环境或分支作用域中可用
如何预防
记录所有必需的密钥并在流水线开始时验证它们
使用密钥管理工具和跨环境一致的命名约定