验证码不显示主因是gd库“有扩展、无函数”：imagecreatefromstring被禁用、freetype缺失致imagettftext静默失败，或php8.4+移除了imagecreatefromjpeg等函数别名；需逐项验证gd_info()、freetype支持、字体路径及输出缓冲。
验证码字母不显示，90%不是代码写错，而是 GD 库在运行时“有扩展、无函数”——imagecreatefromstring被禁、imagettftext因 FreeType 缺失静默失败，或 PHP 8.4+ 下imagecreatefromjpeg等函数名已被移除。
gd_info() 返回 false 或空数组？先确认 GD 真没加载
别急着重装，先看它到底在不在：
- 执行
php -m | grep gd：无输出 → GD 扩展未安装或未启用 - 执行
php -r "var_dump(gd_info());"：返回false或空数组 → GD 已加载但关键功能不可用（常见于 disable_functions 或 FreeType 支持为 false） - 检查
phpinfo()页面中 “GD Support” 是否为 enabled，且 “FreeType Support” 为 true —— 后者决定能否渲染文字（验证码字母依赖它） - Windows 下尤其注意：即使
extension=gd已开启，若系统缺freetype6.dll或libpng16.dll，gd_info()也会返回 false
PHP 8.4+ 验证码空白？imagecreatefromjpeg 等函数已废弃
PHP 8.4 彻底移除了 imagecreatefromjpeg、imagecreatefrompng、imagecreatefromgif 这三个函数别名。老验证码类（如 ThinkPHP 5.x、DedeCMS 插件）直接调用它们，就会报 Fatal error: Uncaught Error: Call to undefined function 或静默返回空白。
- 临时兼容方案：新建
gd_compat.php，内容只含三段定义（不加 BOM、不加额外输出） - 在
php.ini中设置：auto_prepend_file = /绝对路径/gd_compat.php - 必须确保该文件路径可读，且 Web 进程用户（如 www-data 或 IIS_IUSRS）有权限访问
- 更彻底的修复是升级验证码类，改用
imagecreatefromstring(file_get_contents($file))替代原生函数调用
Windows 下字母变成方块或黑块？字体路径与编码踩坑
TP8 默认用 simhei.ttf，但在 Win10/11 中极易因路径含中文、BOM、UTF-8 编码不兼容导致 imagettftext() 失败 —— 不报错，只画空白背景或纯色块。
- 绝对路径优先：
'font' => public_path('static/font/DejaVuSans.ttf')（推荐开源无版权字体） - 若必须用中文字体，路径需转 GBK：
$fontGbk = iconv('UTF-8', 'GBK//IGNORE', $fontPath)，再传给imagettftext - 用 Notepad++ 或 VS Code 检查所有 PHP 文件是否为 “UTF-8 无 BOM” 格式；任何 BOM 或文件末尾空行都会污染图像流
- 字体文件本身需赋予 IIS_IUSRS（IIS）或 Users（Apache）“读取”权限
验证码图片显示红叉或 500？输出缓冲或 Nginx 路由干扰最常见
验证码输出的是纯 PNG/JPEG 二进制流，前面哪怕一个空格、Notice 提示、echo 或 BOM，浏览器都会解析失败，表现为红叉、损坏图或控制台报 “Failed to load resource”。
- 在控制器调用
$captcha->entry()前加ob_clean();（不是ob_end_clean()） - 检查
public/index.php及所有include的配置文件：删掉末尾空行、注释前空格、隐藏字符 - 宝塔/Nginx 用户重点查站点配置：确认
/captcha路径未被location ~ \.php$规则意外代理到 PHP-FPM；它应由 Nginx 直接响应 - 临时关闭错误提示：
ini_set('display_errors', 'off');，避免 Notice/Warn 污染输出
真正难排查的从来不是“GD 没装”，而是“GD 看似装了，但某条链路断在了函数别名、FreeType、字体编码或输出缓冲里”。每个环节都得单独验证，不能只看 php -m 有 gd 就以为万事大吉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
