验证码不显示的主因是PHP GD扩展未启用或输出被干扰；需确认gd是否启用、extension_dir路径正确、无BOM/空格输出、字体路径可读且权限足够。
验证码不显示，大概率不是 Apache 配置本身出错，而是 PHP 的 GD 扩展没真正启用，或输出被意外干扰——Apache 只负责把请求交给 PHP，后续图像生成失败它不会报错，浏览器只收到乱码或空白。
GD 扩展是否真的加载成功
很多人在 php.ini 里取消了 extension=gd 前的分号，却忽略了两个关键点：路径和模块文件名是否匹配当前 PHP 版本。
-
extension_dir必须是绝对路径，比如extension_dir = "C:\php\ext"（Windows）或extension_dir = "/usr/lib/php/20220829/"（Linux，需用php -i | grep extension_dir确认） - PHP 8.2+ 默认启用
gd，但若你用的是精简版或自编译包，仍需手动开启；用php -m | grep gd或访问phpinfo()页面搜索gd段落确认“enabled”字样 - Linux 下常见漏装依赖：
sudo apt install libgd-dev（编译时）或sudo apt install php-gd（包管理器安装）
AddHandler 和 AddType 配置是否冲突
Apache 中若同时存在 AddType application/x-httpd-php .php 和 AddHandler application/x-httpd-php .php，一般没问题；但若还加了 AddType application/x-httpd-php .html 却没配 AddHandler，反而可能让某些旧版 Apache 把 HTML 当纯文本返回，间接影响验证码脚本调用逻辑。
- 确保只保留一组明确的处理器声明，推荐写法：
AddType application/x-httpd-php .phpAddHandler application/x-httpd-php .php - 避免混用
application/x-httpd-php和application/x-php，后者已过时且部分 Apache 版本不识别 - 如果验证码是通过
index.php?act=code这类 URL 加载，重点检查该 PHP 文件本身是否被正常解析（可临时在文件开头加die('running');测试）
输出缓冲与头部干扰问题
验证码脚本一旦在 header() 或图像函数（如 imagepng()）之前有任何输出（空格、BOM、echo、警告），浏览器就收不到合法图片流，表现为空白或“损坏的图像”图标。
立即学习“PHP免费学习笔记（深入）”；
- 用 VS Code 或 Notepad++ 打开验证码 PHP 文件，检查是否启用了“显示所有字符”，确认开头**没有 UTF-8 BOM** 和多余空行
- 在脚本最顶部立即加入：
ob_clean();if (headers_sent($file, $line)) { die("Headers already sent in $file on line $line"); } - 禁用错误报告临时排查：
error_reporting(0);
或确保display_errors = Off在php.ini中生效（否则错误会混在图片数据里）
权限与字体路径是否可读
GD 生成验证码常依赖字体文件（如 font.ttf），而 Apache 子进程（如 www-data 或 apache 用户）可能无权读取你指定的路径。
- 字体路径尽量用绝对路径，避免相对路径引发定位失败
- 检查文件权限：
ls -l /path/to/font.ttf（Linux）或右键属性 → 安全 → 确认IIS_IUSRS或Users组有读取权（Windows） - 临时改用系统默认字体测试，例如 Linux 上用
/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf，Windows 上用C:WindowsFontsrial.ttf - 在验证码脚本中加一行：
var_dump(file_exists('/your/font/path.ttf'));确认路径可达
最容易被忽略的其实是 GD 模块状态和输出缓冲——它们不出现在 Apache 错误日志里，也不触发 HTTP 状态码变化，只能靠 phpinfo() 和脚本内主动探测来验证。别急着改 Apache 配置，先确认 PHP 层是否真能画图。
