Docker构建Flask应用时安装python3-pip遇权限错误求助

执行docker build -t xxx/mywebapp . --pull构建Flask应用镜像时，在RUN apt install python3-pip -y步骤报错，提示权限拒绝访问/usr/lib/python3.10/__pycache__/__future__.cpython-310.pyc.140474748197376，导致python3.10-minimal包配置失败，dpkg返回错误码1，且Ubuntu镜像中安装任何Python包都出现相同问题。

构建日志 #

=> [internal] load build definition from Dockerfile                                                                             
 => => transferring dockerfile: 342B                                                                                             
 => [internal] load .dockerignore                                                                                                
 => => transferring context: 2B                                                                                                  
 => [internal] load metadata for docker.io/library/ubuntu:latest                                                                 
 => [auth] library/ubuntu:pull token for registry-1.docker.io                                                                    
 => [1/6] FROM docker.io/library/ubuntu:latest@sha256:2adf22367284330af9f832ffefb717c78239f6251d9d0f58de50b86229ed1427
 => [internal] load build context                                                                                                
 => => transferring context: 440B                                                                                                
 => CACHED [2/6] RUN apt update                                                                                                  
 => ERROR [3/6] RUN apt install python3-pip -y                                                                                  
------                                                                                                                             
> [3/6] RUN apt install python3-pip -y:                                                                                           

#0 23.86 [Errno 13] Permission denied: '/usr/lib/python3.10/__pycache__/__future__.cpython-310.pyc.140474748197376'dpkg: error processing package python3.10-minimal (--configure):
#0 23.87  installed python3.10-minimal package post-installation script subprocess returned error exit status 1
#0 23.88 Errors were encountered while processing:
#0 23.88  python3.10-minimal
#0 23.94 E: Sub-process /usr/bin/dpkg returned an error code (1)
------
ERROR: failed to solve: executor failed running [/bin/sh -c apt install python3-pip -y]: exit code: 100

原Dockerfile #

FROM ubuntu:latest

# 更新软件包
RUN apt update
# 安装Python和pip
RUN apt install python3-pip -y
RUN pip3 install Flask


WORKDIR /

COPY . .

# 暴露应用端口8000
EXPOSE 8000

# 启动应用
CMD ["python3", "-m","flask","run","--host=0.0.0.0"]

webapp.py代码 #

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def hello():
    return render_template('index.html')

if __name__ == '__main__':
    app.run(port=8000)

方案1：改用官方Python镜像（推荐） #

官方Python镜像已预配置好完整的Python环境，无需手动处理系统级安装问题，更简洁可靠：

# 使用官方Python 3.10轻量镜像（可根据需求调整版本）
FROM python:3.10-slim

# 设置工作目录
WORKDIR /app

# 复制依赖清单并安装Flask（使用--no-cache-dir减少镜像体积）
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 暴露端口
EXPOSE 8000

# 启动应用
CMD ["python3", "-m", "flask", "run", "--host=0.0.0.0"]

同时创建requirements.txt文件：

Flask

方案2：修复Ubuntu镜像的dpkg权限问题 #

如果坚持使用Ubuntu基础镜像，可尝试以下步骤修复：

FROM ubuntu:latest

# 更新软件包并修复dpkg配置问题
RUN apt update && \
    apt install -y --fix-broken && \
    dpkg --configure -a && \
    apt install python3-pip -y && \
    pip3 install Flask

WORKDIR /

COPY . .

EXPOSE 8000

CMD ["python3", "-m","flask","run","--host=0.0.0.0"]

若仍存在权限问题，可临时调整目录权限（仅应急使用，不推荐长期采用）：

FROM ubuntu:latest

RUN apt update && \
    mkdir -p /usr/lib/python3.10/__pycache__ && \
    chmod 777 /usr/lib/python3.10/__pycache__ && \
    apt install python3-pip -y && \
    pip3 install Flask

# 后续步骤同上

方案3：优化Dockerfile构建步骤 #

合并apt命令减少镜像层数，同时清理缓存缩小镜像体积：

FROM ubuntu:latest

RUN apt update && \
    apt install -y python3-pip && \
    pip3 install Flask && \
    apt clean && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY . .

EXPOSE 8000

CMD ["python3", "-m","flask","run","--host=0.0.0.0"]

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