Docker Compose跨平台运行报错：拉取database镜像权限被拒

报错信息 #

Error response from daemon: pull access denied for database, repository does not exist or may require 'docker login': denied: requested access to the resource is denied

核心原因分析 #

• 容器平台不匹配：你的数据库是Linux环境镜像，若当前Docker Desktop切换到了Windows容器模式，Windows容器无法直接运行Linux镜像。此时Docker会尝试拉取Windows版本的database镜像，但Docker Hub上不存在这个公开镜像，因此触发拉取权限/不存在的报错。
• 镜像名称歧义：你本地的镜像名为database，但Docker Compose在找不到对应平台的本地镜像时，会默认去Docker Hub拉取同名公开镜像，而database并非官方或公开的镜像仓库，自然拉取失败。
• 未指定镜像平台：Compose配置里未明确数据库镜像的运行平台，当容器模式切换后，Docker无法匹配到本地对应的跨平台镜像，进而触发远程拉取逻辑。

解决方案 #

1. 匹配容器模式与镜像平台

   • 若数据库是Linux镜像，打开Docker Desktop切换到Linux容器模式；若为Windows镜像则切换到Windows容器模式。
   • 用命令确认当前容器模式：docker system info | grep "OSType"

2. 在Compose中指定镜像平台
   修改数据库服务的配置，添加platform字段强制指定运行平台，确保Docker优先使用本地镜像：

   services:
     database:
       container_name: database
       image: database
       platform: linux/amd64  # 若为Linux镜像，根据实际架构调整（如linux/arm64）
       ports:
         - "1433:1433"
       environment:
         - ACCEPT_EULA=Y
         - SA_PASSWORD=你的密码
     # ... 其他服务配置
   

3. 明确镜像标签
   若本地database镜像有自定义标签（如database:v1），在Compose的image字段写全标签，避免Docker触发默认拉取逻辑：

   image: database:v1
   

4. 验证本地镜像
   执行docker images查看本地镜像列表，确认database镜像的平台信息（PLATFORM列），确保与配置的平台或容器模式一致。

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