PHP验证码图片不显示？检查GD库是否启用

PHP验证码图片不显示，往往不是代码写错了，而是GD扩展未启用或输出被意外污染——GD未加载时imagecreate等函数会静默失败导致脚本空白，而文件开头的BOM、空格、echo等前置输出则会污染图片流，让浏览器报“图像因其本身有错无法显示”；只需通过phpinfo()或php -m确认GD已启用，正确配置php.ini中对应扩展（Windows用php_gd2.dll，Linux/macOS用gd.so），重启Web服务，并确保验证码脚本绝对纯净、无任何输出且在header前调用ob_clean()，问题通常迎刃而解。

GD 扩展没启用，imagecreate 直接报错或静默失败

验证码脚本一运行就空白，或者浏览器提示“图像因其本身有错无法显示”，大概率是 gd 根本没加载。PHP 不会主动报错，而是让 imagecreate、imagecolorallocate 这些函数返回 false，后续调用直接中断——你看到的只是空响应。

验证方式很简单：

• 新建一个 phpinfo.php，内容只有 ，浏览器访问它
• 页面里搜 gd，确认 GD Support 显示 enabled
• 命令行执行 php -m | grep -i gd，有输出说明模块已加载

如果没启用：

• Windows 下检查 php.ini 是否有 extension=php_gd2.dll（注意不是注释掉的状态）
• Linux/macOS 下通常是 extension=gd.so，确认路径正确且文件存在
• 改完必须重启 Web 服务（Apache/Nginx + PHP-FPM），否则不生效

header("Content-Type") 前有任意输出，图片流就被污染

这是最隐蔽也最常踩的坑：哪怕开头多一个空格、BOM 头、echo "" 或 var_dump，浏览器收到的就不是纯 PNG 数据，而是混着 HTML 或乱码的垃圾流，必然显示失败。

排查和修复要点：

• 用编辑器打开验证码文件（比如 verify.php），确保第一行是 ，前面**零字符**（包括不可见的 UTF-8 BOM）
• 在 header() 调用前加一句 if (headers_sent($file, $line)) { die("Headers already sent in $file on line $line"); }，能立刻定位哪行偷偷输出了
• 临时加 ob_clean(); 在 header() 之前，可缓解缓冲区残留问题，但只是补救，不能替代源头清理

输出函数和 MIME 类型不匹配，浏览器拒绝渲染