Docker构建PHP容器安装Imagick遇python3.9-minimal权限错误求助

我在为Laravel9项目构建带Apache的PHP容器时，始终无法解决Imagick依赖引发的问题，尤其是python3.9-minimal导致的权限错误。最后一条RUN指令执行失败，我尝试进入容器修改权限、用sudo执行，但还是存在冲突。

执行失败的RUN指令 #

RUN apt-get update && apt-get install -y libmagickwand-dev --no-install-recommends \
    && pecl install imagick \
    && docker-php-ext-enable imagick

完整Dockerfile内容 #

FROM php:8.2-apache

# PDO PostgreSQL e MySQL
RUN apt-get update && apt-get install -y --no-install-recommends apt-utils
RUN apt-get update && apt-get install -y libpq-dev \
    && docker-php-ext-configure pgsql -with-pgsql=/usr/local/pgsql \
    && docker-php-ext-install pdo pdo_pgsql pgsql pdo_mysql mysqli
RUN apt-get update \
    && apt-get install -y sendmail libpng-dev \
    && apt-get install -y libzip-dev \
    && apt-get install -y zlib1g-dev \
    && apt-get install -y libonig-dev \
    && rm -rf /var/lib/apt/lists/* \
    && docker-php-ext-install zip
RUN apt-get update \
  && apt-get install -y zlib1g-dev libzip-dev wget gnupg \
  && docker-php-ext-install zip opcache

# Composer install
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer
ENV COMPOSER_ALLOW_SUPERUSER 1


RUN a2enmod rewrite

# here docker load but the page display an err-server
# Enable mod_rewrite for images with apache
#RUN if command -v a2enmod >/dev/null 2>&1; then        a2enmod rewrite headers  ;

ENV APACHE_DOCUMENT_ROOT=/var/www/html/public/
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

RUN apt-get install -y libicu-dev
RUN apt-get update && apt-get install -y libjpeg-dev
RUN apt-get update && apt-get install -y libfreetype6-dev

# Configurar extensiones de PHP necesarias
RUN docker-php-ext-install \
    bcmath \
    intl \
    exif \
    pcntl \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j "$(nproc)" gd
RUN apt-get update && apt-get install -y libmagickwand-dev --no-install-recommends \
    && pecl install imagick \
    && docker-php-ext-enable imagick

错误输出信息 #

Setting up python3.9-minimal (3.9.2-1) ...
Traceback (most recent call last):
  File "/usr/lib/python3.9/py_compile.py", line 215, in <module>
    sys.exit(main())
  File "/usr/lib/python3.9/py_compile.py", line 207, in main
    compile(filename, doraise=True)
  File "/usr/lib/python3.9/py_compile.py", line 172, in compile
    importlib._bootstrap_external._write_atomic(cfile, bytecode, mode)
  File "<frozen importlib._bootstrap_external>", line 126, in _write_atomic
PermissionError: [Errno 13] Permission denied: '/usr/lib/python3.9/__pycache__/__future__.cpython-39.pyc.140481138631600'
dpkg: error processing package python3.9-minimal (--configure):
 installed python3.9-minimal package post-installation script subprocess returned error exit status 1
dpkg: dependency problems prevent configuration of python3.9:
 python3.9 depends on python3.9-minimal (= 3.9.2-1); however:
  Package python3.9-minimal is not configured yet.

dpkg: error processing package python3.9 (--configure):
 dependency problems - leaving unconfigured
Setting up libpython3.9-stdlib:amd64 (3.9.2-1) ...
Processing triggers for mailcap (3.69) ...
Processing triggers for libc-bin (2.31-13+deb11u5) ...
Errors were encountered while processing:
 python3.9-minimal
 python3.9
E: Sub-process /usr/bin/dpkg returned an error code (1)

docker-compose.yaml内容 #

version: "3.9"

services:
    php:
        build:
            context: ./php # Indica onde está o arquivo Dockerfile
            dockerfile: Dockerfile
        container_name: php8.2 # Apelido para o container
        volumes:
            - ./src:/var/www/html/ # Irá copiar o conteúdo da pasta src para o container
        ports: # Mapear as portas para ficarem visiveis na máquina host
            - "80:80"
            - "443:443"
        links: # Criar conexão com o container do banco de dados
            - mysql
    mysql:
        image: mysql
        container_name: mysql-coexa
        restart: always
        ports: 
            - "3306:3306"
        command: --default-authentication-plugin=mysql_native_password
        environment:
            MYSQL_DATABASE: test
            MYSQL_PASSWORD: test
            MYSQL_ROOT_PASSWORD: test 
        volumes:
            - ./dump:/docker-entrypoint-initdb.d
            - ./conf:/etc/mysql/conf.d
            - persistent:/var/lib/mysql
        networks:
            - default
volumes:
  persistent:

解决方案 #

1. 修复python3.9-minimal的权限问题 #

错误根源是python3.9-minimal的安装脚本无法写入/usr/lib/python3.9/__pycache__目录。在安装libmagickwand-dev前，先预创建目录并设置权限：

RUN mkdir -p /usr/lib/python3.9/__pycache__ && chmod -R 777 /usr/lib/python3.9/__pycache__

2. 优化Imagick安装指令 #

将权限修复与Imagick安装合并，同时清理apt缓存减少镜像体积：

RUN mkdir -p /usr/lib/python3.9/__pycache__ && chmod -R 777 /usr/lib/python3.9/__pycache__ \
    && apt-get update && apt-get install -y libmagickwand-dev --no-install-recommends \
    && pecl install imagick \
    && docker-php-ext-enable imagick \
    && rm -rf /var/lib/apt/lists/*

3. 替代方案：直接安装php-imagick #

如果上述方法无效，可尝试从Debian仓库直接安装适配PHP版本的imagick扩展：

RUN apt-get update && apt-get install -y php-imagick --no-install-recommends \
    && docker-php-ext-enable imagick \
    && rm -rf /var/lib/apt/lists/*

4. 优化Dockerfile整体结构 #

你的Dockerfile存在多次重复的apt-get update，建议合并相关安装指令，减少缓存层浪费，同时确保所有操作以root用户执行（默认Dockerfile已使用root，无需额外切换）。

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