在 docker 中为 php 安装 gd 扩展时，若重复执行 docker-php-ext-install gd（尤其未带配置参数），会导致第二次安装覆盖掉已正确配置的版本，从而丢失 jpeg、freetype 等依赖支持。
这个问题看似是编译参数或系统库缺失所致，实则源于构建流程中的重复安装陷阱：你的 .gitlab-ci.yml 脚本中既调用了自定义脚本 sh scripts/gd-install.sh（该脚本已正确执行 docker-php-ext-configure gd + docker-php-ext-install gd），又在后续手动追加了 docker-php-ext-install gd —— 这行无参安装会跳过所有 --with-jpeg 等配置，直接使用默认（极简）选项重新编译 GD，最终覆盖掉前一次成功启用 JPEG 的版本。
验证这一点只需观察 gd_info() 输出中 JPEG Support 为空且 FreeType Support 同样为空——这正是未传入 --with-freetype 和 --with-jpeg 参数时的典型表现。
✅ 正确做法是：确保 GD 扩展仅安装一次，且配置与安装严格成对执行。以下是优化后的 gd-install.sh（兼容 PHP 7.4+）：
#!/bin/bash
[[ ! -e /.dockerenv ]] && exit 0
apt-get update && apt-get install -y \
libfreetype6-dev \
libjpeg62-turbo-dev \
libpng-dev \
&& rm -rf /var/lib/apt/lists/*
# 关键：先配置，再安装，且只执行一次
docker-php-ext-configure gd \
--with-freetype=/usr/include/freetype2 \
--with-jpeg=/usr/include \
--with-png-dir=/usr/include
docker-php-ext-install -j$(nproc) gd⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- --with-jpeg=/usr/include 是关键（部分 PHP 版本需显式指定路径，而非仅 --with-jpeg）；
- libjpeg62-turbo-dev 是 Debian/Ubuntu 下 JPEG 开发头文件的正确包名（非 libjpeg-dev，后者在较新镜像中可能不兼容）；
-
绝对避免在脚本外再次调用 docker-php-ext-install gd —— 删除 CI 脚本中这一行：
# ❌ 删除这一行（冗余且有害） - docker-php-ext-install gd
? 验证是否生效：
运行 php -r "var_dump(gd_info()['jpeg']);" 应输出 bool(true)；同时 gd_info() 中 JPEG Support 和 FreeType Support 均应为 1。
总结：GD 扩展的图像格式支持完全取决于编译时的配置参数，而 Docker 构建中“多次安装 = 最后一次胜出”。精准控制安装顺序、杜绝重复调用、显式指定依赖路径，是解决此类问题的核心原则。
