Docker PHP-FPM环境下调用Intervention\Image\Gd\imagejpeg()函数报错问题求助

这个问题的核心是你的PHP GD扩展没有正确编译启用JPEG支持，虽然你尝试了添加--with-jpeg参数，但Dockerfile里的步骤重复、顺序混乱，导致配置始终没生效。我帮你整理了一个精简且正确的Dockerfile，同时解释关键问题点：

修复后的Dockerfile #

FROM php:7.4-fpm
# Arguments defined in docker-compose.yml
ARG user
ARG uid

# 一次性安装所有系统依赖（包括GD需要的库）
RUN apt-get update && apt-get install -y \
    git \
    curl \
    libpng-dev \
    libjpeg62-turbo-dev \
    libfreetype6-dev \
    libonig-dev \
    libxml2-dev \
    zip \
    unzip \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# 正确配置并安装GD扩展（必须紧跟依赖安装步骤）
RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) pdo_mysql mbstring exif pcntl bcmath gd

# 获取最新Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 创建运行Composer和Artisan的系统用户
RUN useradd -G www-data,root -u $uid -d /home/$user $user
RUN mkdir -p /home/$user/.composer && chown -R $user:$user /home/$user

# 设置工作目录
WORKDIR /var/www
USER $user

关键修正说明 #

• 合并依赖安装：把所有系统依赖（包括GD需要的libjpeg62-turbo-dev、libfreetype6-dev）一次性安装，减少镜像构建层数，同时避免重复执行apt-get update导致的缓存问题。
• GD配置顺序正确：docker-php-ext-configure gd必须在依赖安装完成后立即执行，且明确指定--with-freetype --with-jpeg参数，确保编译时包含这些支持。
• 移除冗余步骤：你之前手动编译复制gd.so的操作完全没必要，docker-php-ext-install会自动处理扩展的编译和安装，手动操作反而会覆盖正确的配置。
• 避免重复安装GD：原Dockerfile里两次执行docker-php-ext-install gd，第二次执行会重置之前的配置，导致JPEG支持丢失。

验证修复效果 #

构建并启动容器后，进入容器执行以下命令，检查GD扩展的支持情况：

php -i | grep -A 10 "GD"

如果输出中出现JPEG Support => enabled和Freetype Support => enabled，说明配置生效了，此时再运行Spatie/Medialibrary的图片转换操作就不会报错了。

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