GitHub仓库Packages页面显示空白无法查看关联包的问题咨询

常见触发原因与修复步骤 #

• 校验包发布状态
  不要默认跑了发布命令就算操作成功，先核对发布流程的执行日志（本地终端日志/仓库CI运行日志），确认没有403/404权限报错、配置不匹配类提示，存在明确的发布成功标识才算完成发布。只要发布流程未实际执行成功，仓库就只会展示Packages入口和不同包类型的发布引导，不会显示任何包资源。
  不同包类型的核心校验点：
  • npm类包：确认.npmrc配置的registry地址为GitHub Packages对应地址，包scope与仓库所属账号/组织名完全匹配，发布用的token已开通write:packages权限
  • Docker类镜像：确认镜像tag前缀为ghcr.io/所属账号名/镜像名，push操作无权限报错
  • Maven/Gradle类包：确认构建配置中分发仓库地址填写正确，认证token权限符合要求
• 手动绑定包与目标仓库
  GitHub Packages不会自动绑定发布来源仓库，就算是在目标仓库的CI流程中完成发布，也可能出现包未关联仓库的情况。直接通过个人账号下拉菜单进入Your packages列表，如果能在列表中找到你发布的包，进入包详情页选择Connect repository，手动绑定到目标仓库，绑定完成后刷新仓库页面即可正常展示包内容。
• 核对权限与可见性配置
  • 私有仓库/私有包场景下，确认当前访问账号具备仓库至少读权限，组织级私有包需确认组织未开启第三方访问限制
  • 若包本身设置为私有可见性，非授权账号访问时只会看到发布引导页，可进入包详情页将可见性调整为与仓库一致的权限范围
• 等待同步延迟
  首次发布包后，GitHub侧存在最长10分钟的同步缓存周期，发布完成后立刻访问会出现页面无内容的情况，等待10分钟后通过强制刷新（Ctrl+F5）清除浏览器缓存再访问即可。

异常表现参考 #

• 仓库列表展示Packages入口：
• 点击入口后仅展示发布引导页：
• 仓库主页无包内容模块：

按上述顺序逐一排查即可覆盖绝大多数场景，无需额外修改仓库其他配置。

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