GitLab容器镜像仓库含null bytes的异常标签无法删除求助

我之前也碰到过GitLab容器仓库里这种异常标签的糟心事，大概率是后端元数据同步或者存储出了小问题，给你几个按优先级来的解决思路：

• 用GitLab API绕开UI限制删除
  Web UI删不了的话，API是最靠谱的替代方案。先准备好个人访问令牌（得有api和write_registry权限，在项目Settings -> Access Tokens里创建），然后按步骤来：

  1. 获取项目ID（项目主页右上角就能看到）和镜像仓库ID：

     curl --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.com/api/v4/projects/<项目ID>/registry/repositories"
     

  2. 列出仓库所有标签，找到那两个异常条目（JSON里name字段可能是null或者异常值）：

     curl --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.com/api/v4/projects/<项目ID>/registry/repositories/<仓库ID>/tags"
     

  3. 调用删除API，要是标签名是特殊值（比如null bytes），试试URL编码后的%00，或者直接用返回里的path字段值：

     curl --request DELETE --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.com/api/v4/projects/<项目ID>/registry/repositories/<仓库ID>/tags/<标签名或path>"
     

• 用仓库清理规则清理未标记镜像
  这些异常标签可能对应着无有效标记的镜像，GitLab的清理规则能自动处理这类资源：
  进入项目的Packages & Registries -> Container Registry，点击右上角的Clean up policy，创建一个规则（比如清理超过1天的未标记镜像），手动触发执行后，看看异常标签会不会被顺带清掉。

• 触发仓库元数据刷新
  有时候是元数据缓存同步的问题，试试这些操作强制刷新：

  • 往仓库推一个新的镜像标签，完成后刷新页面；
  • 或者在Settings -> Packages & Registries -> Container Registry里暂时禁用再重新启用仓库功能（注意：这会清空所有镜像，一定要谨慎操作！）。

• 联系GitLab官方支持兜底
  如果上面的方法都不管用，那就是GitLab后端的问题了，得找官方帮忙：
  去GitLab的Support页面提交工单，把问题说清楚：异常标签的显示情况、试过的删除方法、报错内容，附上项目路径和仓库ID这些信息，官方团队能直接在后端排查清理这些异常条目。

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