GD扩展未启用会导致imagecreatefromjpeg等函数报错或返回false，需先通过phpinfo()确认“GD Support”为enabled且“GD Version”非空，再检查disable_functions、环境配置一致性及重启服务。
GD扩展没开，imagecreatefromjpeg、imagepng 这类函数直接报错或返回 false，不是代码写错了，是PHP根本没这个能力——先确认状态，再动手改，别一上来就重装。
怎么快速确认GD到底有没有真正启用
别只信 php -m | grep gd，CLI 和 Web 环境可能用不同 php.ini。打开一个 PHP 文件写 <?php phpinfo(); ?>，浏览器访问它，在页面里搜 gd，重点看两行：
-
GD Support显示enabled -
GD Version不为空（比如显示bundled (2.1.0 compatible)）
如果这两项任一为 disabled 或空白，说明 GD 没真正活过来。此时 gd_info() 会返回 false 或空数组，ThinkPHP/Laravel 的验证码、图片缩略图等都会直接崩在初始化阶段。
常见“开了但等于没开”的坑
扩展名对了，配置也写了，还是报错？大概率踩了这几个隐形雷：
立即学习“PHP免费学习笔记（深入）”；
-
disable_functions里禁了关键函数，比如imagecreatefromstring、imagecolorallocate—— 验证码和 Intervention Image 都依赖它们 - Docker 环境下重复执行
docker-php-ext-install gd，第二次会覆盖掉第一次带--with-jpeg的编译结果，导致gd_info()里JPEG Support显示disabled - Mac MAMP 或 Windows WAMP 中 GD 扩展开关藏在图形界面里，光改 php.ini 没用，得进控制面板手动勾选
- Ubuntu/Debian 上装了
php-gd，但 PHP 版本号不匹配（比如系统是 php8.2，你装的是 php8.1-gd），得用apt install php8.2-gd对齐
改完记得验证基础功能是否真通
别只看 phpinfo()，写个最小测试脚本跑一下：
<?php
$im = imagecreatetruecolor(100, 100);
if (!$im) {
die('imagecreatetruecolor failed');
}
$white = imagecolorallocate($im, 255, 255, 255);
if (!$white) {
die('imagecolorallocate failed');
}
imagepng($im);
imagedestroy($im);
?>
能输出一张白图，说明 GD 已可用；如果空白、乱码或 500，就说明还有残留问题——比如输出前有空格、BOM、或 header 已被发过。
重启服务不是可选项，是必做动作
改完 php.ini 或装完扩展后，Apache/Nginx/PHP-FPM 必须全部重启，否则配置不生效。Docker 用户注意：不是 docker restart 容器就行，得重建镜像或确保 entrypoint 里重新加载了扩展。
尤其容易忽略的是 CLI 和 Web SAPI 使用不同配置文件，php -i | grep "Loaded Configuration File" 和网页里的 phpinfo() 显示的路径必须一致，否则你会在终端里测通了，网页里依然报错。
