无法删除私有Docker Registry镜像标签：tag digest not found 404报错求助

这个404报错其实挺常见的，结合你能在仓库里看到标签和摘要的情况，大概率是下面几个原因导致的，咱们一个个捋清楚：

1. 脚本使用的Digest和Registry实际认可的Digest不匹配 #

你看到的摘要可能是镜像manifest的内容摘要，但Registry V2里，每个tag对应的是一个唯一的Docker-Content-Digest（这个值在请求manifest的响应Header里）。如果你的registry.pl脚本获取Digest的逻辑有问题——比如误拿了多架构镜像中某个子manifest的Digest，而不是tag指向的manifest list的Digest——那用这个错误的Digest去请求删除，自然会返回404。

验证方法：
用curl手动请求该tag的manifest，查看返回Header里的正确Digest：

curl -v http://localhost:XXX/v2/sample-image/manifests/1234

在响应Header里找Docker-Content-Digest字段，这个才是Registry认可的、用于删除的正确Digest，对比脚本里使用的Digest是否一致。

2. Registry垃圾回收已清理Manifest，但Tag元数据未同步更新 #

如果之前你执行过Registry的垃圾回收命令（registry garbage-collect），有可能该tag关联的manifest已经被清理掉了，但Registry的tag索引缓存还没更新——这就导致你还能在标签列表里看到这个tag，但实际对应的manifest已经不存在了，这时执行删除操作自然会报404。

验证方法：
直接用curl请求该tag的manifest，如果返回404，就说明manifest确实被清理了，只是标签列表还没刷新：

curl http://localhost:XXX/v2/sample-image/manifests/1234

这种情况重启一下Registry服务，一般就能刷新标签列表了。

3. 脚本的API调用逻辑不符合Registry V2规范 #

Registry V2没有直接删除tag的API，正确的删除流程是：先获取tag对应的manifest Digest，然后通过DELETE /v2/<image-name>/manifests/<digest>端点删除manifest，Registry会自动清理关联的tag引用。如果你的registry.pl脚本逻辑有误——比如试图直接删除tag（而不是对应的manifest），或者构造的请求路径错误——就会触发404报错。

验证方法：
查看registry.pl的源码，确认它是否正确获取了Docker-Content-Digest，并且调用的是正确的DELETE端点。你也可以手动用正确的Digest执行删除请求，看是否成功：

curl -X DELETE http://localhost:XXX/v2/sample-image/manifests/<正确的Digest值>

4. 权限伪装成404报错 #

有些Registry配置了严格的权限控制，当你的账号没有删除manifest的权限时，Registry可能不会返回明确的403（禁止访问），而是返回404来隐藏资源存在的事实。这种情况虽然报错是404，但本质是权限问题。

验证方法：
查看Registry的访问日志，看是否有关于权限拒绝的记录；或者用拥有管理员权限的账号执行删除操作，看是否能成功。

内容的提问来源于stack exchange，提问作者R.V