PHP 8.4验证码不显示主因是imagecreatefromjpeg等函数别名被移除，需启用GD扩展、设gd.jpeg_ignore_warning=1、补全兼容函数并用auto_prepend_file加载gd_compat.php。
PHP 版本不兼容是验证码不显示的高频原因，尤其在升级到 PHP 8.4 或降级到 PHP 5.x 时最明显——不是“可能出问题”，而是 GD 函数调用、字符集处理、错误抑制机制全变了，直接导致图像流中断或字体加载失败。
GD 函数在 PHP 8.4 中被移除别名
PHP 8.4 彻底删除了 imagecreatefromjpeg、imagecreatefrompng、imagecreatefromgif 这类函数别名（它们曾是 imagecreatefromstring(file_get_contents($file)) 的简写）。但很多老验证码类（如 ThinkPHP 5.x、PbootCMS 自带类）仍直接调用这些别名，结果就是调用失败、脚本静默退出、返回空响应。
- 用
php -r "var_dump(function_exists('imagecreatefromjpeg'));"检查是否返回bool(false) - 不要改框架源码——在 php.ini 中设置
auto_prepend_file加载兼容层文件 - 该文件必须放在 PHP 扩展目录下（如
/www/server/php/84/lib/php/extensions/no-debug-non-zts-20230831/gd_compat.php），且内容仅包含函数存在性判断 +imagecreatefromstring回退逻辑 - 重启 PHP 服务后，再验证
phpinfo()页面中 GD 模块状态是否为 “enabled” 且无警告
PHP 5.x 下 FreeType 支持缺失导致空白图
PHP 5.6/7.2 等旧版本若未编译进 FreeType 支持，imagettftext() 会直接失败，验证码变成纯色块或完全空白，但错误日志里往往只报 “failed to create image” 这类模糊提示。
- 运行
php -r "var_dump(gd_info()['FreeType Support']);"，必须看到bool(true) - Ubuntu/Debian 系统补装：
sudo apt install libfreetype6-dev，然后重新编译 PHP（不能只启 extension） - CentOS/RHEL 系统：
sudo yum install freetype-devel，同样需重编 PHP - 确认字体文件路径是 Unix 风格（无盘符、无反斜杠）、无中文、无空格，且 Web 进程用户（如
www-data）有读权限
输出缓冲被 BOM 或 warning 污染
无论 PHP 版本新旧，只要验证码脚本开头存在 UTF-8 BOM、空行、echo、var_dump 或未捕获的 Notice，图像二进制流就会被文本内容截断，浏览器收到的是“PNG 头部损坏”响应，表现为红叉或空白。
立即学习“PHP免费学习笔记（深入）”；
- 用 VS Code 或 Notepad++ 打开验证码控制器/入口文件，右下角确认编码是 “UTF-8 without BOM”
- 在生成图像前强制加
ob_clean();（不是ob_end_clean()） - 临时关闭错误输出：
ini_set('display_errors', '0');，避免 Warning 写入图像流 - 用浏览器开发者工具看 Network → 验证码请求的 Response，如果开头是 HTML 或 PHP 错误堆栈，就坐实了输出污染
真正棘手的从来不是“哪个版本能用”，而是同一套代码在 PHP 8.4 和 PHP 7.3 下，GD 模块启用方式、字体加载路径解析、甚至 session 启动时机都不同——别依赖“换版本就好”，先用 gd_info() 和 headers_sent() 把当前环境的真实能力摸清再说。
