PbootCMS后台验证码不显示_GD库_BOM头_session_完整解决
PbootCMS后台登录页验证码显示为叉或空白，按以下顺序排查。
GD库未安装：验证码用GD库生成图片。phpinfo看gd模块是否存在。没有的话宝塔→软件商店→对应PHP→安装扩展→gd→安装，重启PHP。CentOS命令行：`yum install -y php-gd`（对应PHP版本）。装完验证码应该显示。
BOM头或空格输出：PHP文件在session_start()之前有输出，验证码图片损坏。用编辑器（Notepad++、VSCode）打开验证码相关文件，检查编码是否UTF-8无BOM。PbootCMS的验证码在`apps/admin/controller/LoginController.php`或`extend/`下的验证码类。文件开头`<?php`前不能有任何字符（空格、换行、BOM）。用编辑器转码为UTF-8无BOM。
session目录不可写：验证码值存在session里，session保存目录没写权限，验证码生成失败。phpinfo看session.save_path，默认/tmp。检查/tmp权限（1777）。如果自定义了session路径，确保该目录存在且所有者www，权限755。`chown -R www:www /path/to/session`。
输出缓冲问题：php.ini里`output_buffering`设为On或足够大的值。验证码图片用header('Content-type: image/png')输出，之前有任何输出就失败。在验证码生成代码前加`ob_clean()`清除输出缓冲区，确保图片数据干净。
字体文件缺失：部分PbootCMS版本验证码用了自定义字体，字体文件在`static/fonts/`或验证码类同目录。检查字体文件（.ttf）是否存在，缺失从安装包补。或修改验证码类，不用自定义字体用GD内置字体。
验证码配置关闭：config.php里验证码开关被关了。后台登不进去的话，直接改数据库或配置文件，把验证码设为开启。PbootCMS某些版本可以在`config/config.php`里找`'verify' => true`确保是true。
浏览器缓存：旧的验证码图片被缓存，按Ctrl+F5强制刷新登录页。或换浏览器、开无痕模式测试。验证码图片URL加随机参数防缓存：``。
PHP版本不兼容：PbootCMS某些版本在PHP7.4以上验证码有bug。切换PHP版本到7.2或7.3测试。如果低版本正常高版本不行，升级PbootCMS到最新版，官方修复了兼容性问题。
测试方法：直接访问验证码图片URL（在登录页右键验证码图片→复制图片地址→浏览器打开），看是显示图片还是报错。报错信息会指向具体原因（如"Call to undefined function imagettftext"说明GD库没装或不支持FreeType）。
临时绕过：紧急情况下需要登录后台，可以注释掉验证码验证代码，登录后再修复。在LoginController的登录验证方法里注释验证码检查的代码段，用账号密码直接登录。登录后立刻恢复代码并修复验证码问题，不要长期关闭验证码。
更新时间：2026-08-26 17:32:30
上一篇：PbootCMS后台系统内容修改不生效_缓存问题_模板标签_排查解决