本地可用的Heroku builds:output命令在GitHub Actions中无法执行

核心原因 #

GitHub Actions环境里的Heroku CLI要么版本比本地旧，要么缺少heroku-builds插件——builds:output命令正是由这个插件提供的，本地可能默认已安装，但Actions环境的CLI不带该插件。

解决方案 #

1. 升级Heroku CLI到最新版 #

在GitHub Actions的YAML配置里先添加版本检查和升级步骤：

- name: 检查Heroku CLI版本
  run: heroku --version

- name: 升级Heroku CLI到最新版
  run: npm install -g heroku

2. 安装heroku-builds插件 #

手动安装提供builds:output命令的插件：

- name: 安装heroku-builds插件
  run: heroku plugins:install heroku-builds

完整示例配置 #

把上述步骤整合到你的Actions配置中，完整流程如下：

name: 获取Heroku构建日志
on: [push]

jobs:
  fetch-build-logs:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 配置Heroku凭证
        run: |
          echo "machine api.heroku.com login ${{ secrets.HEROKU_EMAIL }} password ${{ secrets.HEROKU_API_KEY }}" >> ~/.netrc
          echo "machine git.heroku.com login ${{ secrets.HEROKU_EMAIL }} password ${{ secrets.HEROKU_API_KEY }}" >> ~/.netrc

      - name: 升级Heroku CLI
        run: npm install -g heroku

      - name: 安装heroku-builds插件
        run: heroku plugins:install heroku-builds

      - name: 获取最新构建日志
        run: heroku builds:output -a my-app

验证要点 #

在Actions执行日志里确认：

• CLI版本已和本地保持一致
• heroku-builds插件安装成功
• builds:output命令正常执行并返回日志

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