在php:7.4.2-apache Docker镜像中安装GD扩展失败如何解决

• PHP版本与配置参数不匹配：PHP 7.4 及以上版本的GD扩展已废弃--with-freetype-dir、--with-jpeg-dir这类带路径后缀的配置参数，统一使用--with-freetype、--with-jpeg即可
• apt包索引丢失：你之前的Dockerfile中执行apt-get update安装基础依赖后，直接删除了/var/lib/apt/lists/*，后续安装新的系统依赖前没有重新执行apt update，导致包索引不存在，无法找到对应软件包
• 扩展重复加载：docker-php-ext-install命令安装PHP扩展成功后会默认自动启用扩展，不需要额外执行docker-php-ext-enable gd，额外执行会重复写入扩展加载配置，导致重复加载告警，甚至扩展加载失败
• GD依赖不完整：你最后一次调整只安装了zlib1g-dev和libpng-dev，缺少freetype、jpeg相关的依赖库，导致GD扩展编译时功能不完整，无法正常加载

FROM php:7.4.2-apache

RUN pecl install xdebug && docker-php-ext-enable xdebug && docker-php-ext-install mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql && pecl install apcu && docker-php-ext-enable apcu \
&& echo "\n\
xdebug.mode = debug \n\
xdebug.start_with_request = yes \n\
xdebug.client_port = 9003 \n\
xdebug.client_host = 172.18.0.1 \n\
xdebug.log = \"C:\\xdebug_log\\xdebug.log\" \n\
xdebug.idekey = VSCODE \n\
" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

# 合并所有系统依赖安装，避免重复update和清理缓存
RUN apt-get update \
    && apt-get -y --no-install-recommends install \
        libfontconfig1 libxrender1 libxext6 \
        zlib1g-dev libpng-dev libfreetype6-dev libjpeg62-turbo-dev libzip-dev zip \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j "$(nproc)" gd zip opcache \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*

RUN cd /usr/local/etc/php/conf.d/ && \
  echo 'memory_limit = -1' >> /usr/local/etc/php/conf.d/docker-php-memlimit.ini

COPY 000-default.conf /etc/apache2/sites-available/000-default.conf

构建镜像并启动容器后，执行以下命令确认GD扩展正常加载：

docker exec -it 你的容器名 php -m | grep gd

正常执行会输出gd，此时访问phpinfo页面也能看到完整的GD扩展信息。

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