推送Docker镜像至Heroku Registry时报401错误（已显示docker login成功）

问题原因及修复方案 #

你遇到的unauthorized: authentication required但docker login返回成功的问题，是Heroku容器Registry的常见校验问题，按以下步骤逐一排查即可解决：

• 检查登录命令是否正确
  不要直接执行无地址的docker login，该命令默认登录Docker Hub而非Heroku私有Registry。正确登录方式有两种：
  1. 使用Heroku CLI一键登录：执行heroku container:login，会自动读取本地Heroku账号的认证信息完成Registry登录，无需手动输入账号密码
  2. 手动指定Registry登录：执行docker login registry.heroku.com，用户名填Heroku账号绑定的邮箱，密码填写Heroku账号的API密钥，不要填账号的登录密码
• 检查镜像标签格式是否合规
  推送的镜像标签必须严格符合registry.heroku.com/<你的Heroku应用名>/<进程类型>格式：
  • <你的Heroku应用名>必须和你在Heroku后台创建的应用名称完全一致，区分大小写
  • <进程类型>只能是你应用配置的合法进程类型，最常用的是web，不要随意填写自定义字符串
• 清理过期的本地Docker认证信息
  如果上述操作后仍报错，可先删除本地Docker配置中存储的Heroku认证记录：
  打开Docker认证配置文件（Linux/macOS路径：~/.docker/config.json，Windows路径：C:\Users\你的用户名\.docker\config.json），删除所有包含registry.heroku.com的条目，保存后重新执行登录操作即可。
• 验证账号权限
  确认当前使用的Heroku账号拥有目标应用的推送权限，可执行heroku apps查看当前账号有权限的应用列表，确认你使用的应用名在列表内。

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