Docker构建Django镜像失败：insufficient_scope权限错误求助

问题情况 #

尝试为Django项目构建Docker镜像，已执行sudo docker login，但仍报错，该问题在macOS M1和树莓派4B上均能复现。

原Dockerfile #

FROM python3.9.2-slim

ENV PYTHONUNBUFFERED 1

RUN sudo apt update -y && sudo apt upgrade -y

RUN mkdir /app
WORKDIR /app

COPY requirements.txt /app/
RUN pip install --user -r requirements.txt

COPY . /app/

CMD python3 manage.py runserver

构建命令及错误输出 #

执行命令：

sudo docker build . -t ttapp-image

错误输出：

[+] Building 2.1s (4/4) FINISHED          docker:default
 => [internal] load build definition from Dockerfile  0.0s
 => => transferring dockerfile: 279B                0.0s
 => [internal] load .dockerignore                   0.0s
 => => transferring context: 2B                     0.0s
 => ERROR [internal] load metadata for docker.io/library/python3.9.2-slim:latest:  2.0s
 => [auth] library/python3.9.2-slim:pull token for registry-1.docker.io  0.0s
------
 > [internal] load metadata for docker.io/library/python3.9.2-slim:latest:
------
Dockerfile:1
--------------------
   1 | >>> FROM python3.9.2-slim
   2 |     
   3 |     ENV PYTHONUNBUFFERED 1
--------------------
ERROR: failed to solve: python3.9.2-slim: pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failed

问题原因及修复 #

核心问题 #

1. 基础镜像名称错误：官方Python镜像的正确标签格式是python:<版本号>-slim，原Dockerfile里的python3.9.2-slim缺少前缀python:，导致Docker找不到对应镜像。
2. 容器内无需sudo：Docker容器默认以root用户运行，RUN命令中添加sudo完全多余，甚至会因容器未安装sudo而报错。
3. 架构适配：macOS M1和树莓派4B都是arm64架构，官方Python镜像已支持多架构，修正镜像标签后会自动拉取对应架构的镜像。

修正后的Dockerfile #

FROM python:3.9.2-slim

ENV PYTHONUNBUFFERED 1

RUN apt update -y && apt upgrade -y

RUN mkdir /app
WORKDIR /app

COPY requirements.txt /app/
RUN pip install --user --no-cache-dir -r requirements.txt

COPY . /app/

CMD python3 manage.py runserver

额外优化点 #

• 移除apt upgrade：官方slim镜像的包版本已经足够新，执行upgrade会增大镜像体积且容易导致缓存失效。
• 添加--no-cache-dir给pip：减少镜像体积，避免缓存无用的安装文件。
• 生产环境替换runserver：Django自带的runserver仅适合开发，生产环境建议使用Gunicorn或uWSGI等专业WSGI服务器。

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