GitHub Actions发布Gem包至新仓库失败，本地推送后包不显示求助

1. 默认GITHUB_TOKEN权限不足 #

新仓库的GitHub Actions默认令牌可能缺少推送包的必要权限，这是最常见的原因。

• 解决方法：
  • 进入新仓库的「Settings」→「Actions」→「General」→「Workflow permissions」，勾选「Read and write permissions」，保存后重新触发发布流程。
  • 或者直接在Workflow的jobs.build下添加权限声明，强制赋予令牌权限：

    jobs:
      build:
        runs-on: ubuntu-latest
        permissions:
          packages: write
          contents: read
        steps:
          # 原步骤保持不变
    

2. Gem名称与仓库名称不匹配 #

GitHub Packages要求Gem包的名称必须和仓库名称完全一致（包括大小写），否则即使推送成功，包也不会关联到当前仓库，只会显示在个人账号的Packages列表里，不会出现在仓库的Packages页面。

• 解决方法：
  • 检查Gem的gemspec文件中的name字段，确保和新仓库名称完全相同（比如仓库叫my-ruby-gem，Gem名称也必须是my-ruby-gem）。

3. 新仓库Packages配置问题 #

新仓库可能未正确配置Packages的可见性，或者存在同名包冲突。

• 解决方法：
  • 进入新仓库的「Settings」→「Packages」→「Package visibility」，确认设置为「Public」或「Private」（和推送的包权限匹配）。
  • 如果个人账号下已有同名包，需要删除旧包或者重命名当前Gem/仓库，否则新包无法关联到当前仓库。

4. 本地PAT推送后的显示问题 #

本地用PAT推送成功但仓库页面不显示，本质还是Gem名称和仓库名称不匹配，或者PAT的权限虽然能推包，但没关联到目标仓库。

• 解决方法：
  • 确认PAT拥有write:packages和repo权限，同时推送时确保Gem名称和仓库名称完全一致。

额外排查步骤 #

• 在Workflow的「Publish Gem」步骤前添加打印命令，确认找到的Gem文件正确：

  PACKAGE=$(find build/gems -type f | sort | tail -n 1)
  echo "待推送的包文件：${PACKAGE}"
  

• 检查ORGANIZATION变量是否正确替换为你的GitHub用户名/组织名，避免推送地址错误。

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