PHP无法生成图片主因是GD扩展未启用或输出被污染，需检测函数存在性、FreeType支持、输出缓冲及字体路径权限。
PHP 无法生成图片，90% 是 GD 扩展没启用或输出流程被污染，不是代码写错。
GD 扩展是否真启用？别信 phpinfo() 页面的“GD Support: enabled”
phpinfo() 显示 GD 启用，不代表所有图像函数都可用。有些主机商或 Docker 镜像会禁用部分函数（如 imagecreatetruecolor、imagettftext），只留基础函数。
- 直接运行这段检测代码，看实际函数是否存在：
<?php $funcs = ['imagecreatetruecolor', 'imagecolorallocate', 'imagestring', 'imagepng']; foreach ($funcs as $f) { echo "$f: " . (function_exists($f) ? '✅' : '❌') . " "; } ?> - 如果
imagecreatetruecolor❌，说明你用的是极简 GD 编译版本（比如 Alpine Linux 的php-gd包默认不带 freetype 支持），此时imagettftext必然失败，连带报 “Could not find/open font” —— 根本不是路径问题，是扩展压根没编译字体支持 - 验证方式：运行
php -r "print_r(gd_info());"，检查"FreeType Support"和"T1Lib Support"是否为true
header("Content-Type: image/png") 前有空格？ob_clean() 不是万能解药
脚本开头 BOM、UTF-8 无 BOM 保存错误、echo 漏网、甚至 PHP 错误警告（如 Notice）都会在图像流前输出内容，导致浏览器收到乱码或空白。
-
ob_clean()只能清当前输出缓冲区，但若之前已echo过且缓冲未开启，它就无效 —— 所以必须配合ob_start()在脚本最顶部第一行调用 - 更稳妥的做法是：先关所有非致命错误显示：
error_reporting(E_ALL & ~E_NOTICE & ~E_WARNING);
再加ob_start()，最后在imagepng()前执行ob_end_clean()（不是ob_clean()） - 临时调试时，用
headers_sent($file, $line)检查 header 是否已被发送，并定位到哪行、哪个文件提前输出了内容
imagestring() 能画字，但 imagettftext() 报错？字体路径只是表象
imagettftext() 失败的真正原因，80% 是 GD 缺少 FreeType 支持，20% 才是路径问题。盲目改路径没用。
立即学习“PHP免费学习笔记（深入）”；
- 确认 FreeType 已启用后，再处理路径：
__DIR__ . '/fonts/arial.ttf'比'./fonts/arial.ttf'可靠；绝对路径优先，避免 include_path 干扰 - Windows 下注意反斜杠转义：用
str_replace('/', DIRECTORY_SEPARATOR, $path)或直接写双反斜杠'C:\fonts\simhei.ttf' - 字体文件权限要可读（
chmod 644），且不能是 .ttc 合集（GD 只认单字体 .ttf/.otf） - 快速验证字体是否被识别：用
is_readable($fontPath)+filesize($fontPath) > 0双重判断
验证码图片返回空白或 500？先保存到磁盘再排查
浏览器看不到图 ≠ 图没生成。把图像先写入文件，能绕过所有 header / 输出缓冲干扰，直击 GD 逻辑层问题。
- 在
imagepng($im)前加一句：imagepng($im, __DIR__ . '/debug_captcha.png');
然后直接访问该 PNG 文件。能打开 → 问题出在 header 或输出环节；打不开或报错 → 问题在 GD 创建或绘制阶段 - 保存失败常见原因：
__DIR__ . '/debug_captcha.png'所在目录无写权限（chmod 755不够，需775或属主匹配 web server 用户），或磁盘满、SELinux 限制 - 如果保存成功但图像内容异常（如只有背景、缺文字），检查
imagecolorallocate()返回值是否为false（颜色分配失败常因参数超范围，如传了 300 当 R 值）
真正卡住人的，往往不是“怎么画”，而是“为什么画不出来”——GD 编译选项、PHP 运行时限制、Web 服务器模块配置，这些底层细节比语法更难 debug。每次遇到空白图，先跑一遍函数存在性检测 + 磁盘保存验证，比反复改 header 或字体路径高效得多。
