GD library missing 错误通常并非PHP未安装GD扩展，而是运行时gd_info()返回false、关键图像函数被disable_functions禁用，或CLI与Web环境配置不一致导致检测失败。
为什么 GD library missing 错误不是真的缺 GD 扩展
ThinkPHP 报这个错，大概率不是 PHP 真没装 GD，而是它在运行时没检测到可用的图像处理函数。常见原因是：gd_info() 返回 false、imagecreatefromstring() 被禁用，或启用了 disable_functions 却没留意这些函数名。
- 检查
phpinfo()页面里是否真有 GD 模块 —— 重点看 “GD Support” 是 enabled，且 “GD Version” 不为空 - 在命令行执行
php -m | grep gd，确认扩展已加载（CLI 和 Web SAPI 可能用不同配置） - 查看
php.ini中的disable_functions，确认没禁掉imagecreatefromstring、imagecolorallocate、imagepng等验证码依赖函数
ThinkPHP 5/6 验证码类对 GD 的实际调用链
TP5 的 Captcha 类、TP6 的 think\captcha\Captcha 默认走 GD 驱动，但底层只依赖几个核心函数，不强制要求全部 GD 功能。只要 imagecreate + imagecolorallocate + imagestring + imagepng 这四个可用，就能出图。
- TP5.1+ 默认使用
think\captcha\driver\Gd，构造时会调用gd_info()判断可用性；若返回空数组或['version' => '']，直接抛异常 - TP6.0+ 支持切换驱动（如
Imagick），但 GD 仍是默认；即使 GD 部分功能缺失（比如没编译 freetype 支持），只要基础绘图函数存在，验证码仍可生成（只是字体可能回退为默认点阵） - 注意：部分 Docker 镜像（如
php:8.2-apache）默认不带 GD，需手动docker-php-ext-install gd并确保libfreetype6-dev、libjpeg-dev等编译依赖已安装
快速验证和绕过 GD 检测的方法
不推荐永久绕过，但临时排查时可加一行调试代码，确认是不是 GD 检测逻辑误判：
var_dump(gd_info()); // 看输出是否为 false 或空数组
如果确认 GD 实际可用但被误判，可在验证码配置中显式启用：
立即学习“PHP免费学习笔记（深入）”；
- TP5：在
config/captcha.php中设'use_gd' => true，并确保'check' => false不影响运行时判断 - TP6：在
config/captcha.php中把'driver' => 'gd'显式写出，避免自动探测失败 - 更彻底的办法：在入口文件（如
public/index.php）顶部加extension_loaded('gd') || die('GD not loaded');，排除加载问题
Linux 下安装 GD 扩展的最小必要步骤
CentOS/RHEL 和 Ubuntu/Debian 的包名不同，但核心是装对开发库再重编 PHP 扩展。别只装 php-gd 包就以为完事 —— 它可能只是运行时包，没触发扩展加载。
- Ubuntu/Debian：
sudo apt install php-gd后必须重启 Web 服务（sudo systemctl restart apache2或sudo systemctl restart php8.2-fpm） - CentOS 8+/AlmaLinux：
sudo dnf install php-gd，同样要重启 php-fpm 或 httpd - Docker（官方镜像）：
RUN docker-php-ext-configure gd --with-jpeg-dir=/usr/include/ && docker-php-ext-install gd，注意顺序：先 configure 再 install - Windows：确认
php.ini中extension=php_gd2.dll已取消注释，且php_gd2.dll文件真实存在于ext/目录下
GD 缺失的表象背后，九成是函数被禁用或 SAPI 配置不一致。盯住 gd_info() 的返回值，比反复重装扩展更省时间。
