PBootCMS后台验证码常见问题_验证码不显示_点击刷新无效_解决方法汇总
PbootCMS后台验证码不显示，最常见的原因是GD库没装或没启用。验证码需要PHP的GD扩展生成图片。检查方法：建一个phpinfo页面，看gd模块是否存在。没有的话在宝塔软件商店→PHP设置→安装扩展，找到gd点安装，装完重启PHP。验证码就能正常显示了。
输出了多余内容导致验证码图片损坏。PHP文件如果有BOM头、空格、换行，在session_start()之前输出了内容，验证码图片就会损坏显示不出来。用编辑器（Notepad++、VSCode）打开`apps/admin/controller/LoginController.php`或验证码生成文件，检查文件编码是否为UTF-8无BOM，PHP标签前有没有空格。去掉多余输出，验证码恢复正常。
session目录不可写也会导致验证码异常。PbootCMS用session存验证码，session保存目录没写权限的话，验证码存不进去，验证永远失败。检查PHP的session.save_path配置，phpinfo里能看到路径。确保该目录所有者是www，权限755。宝塔环境下默认session目录是`/tmp`，一般没问题，手动改过的要确认权限。
验证码点击刷新没反应，是JS路径错误或缓存问题。后台登录页的验证码图片点击刷新调用JS函数，如果JS文件加载失败，点击就没效果。按F12看控制台有没有JS报错，检查`static/admin/js/`下的JS文件是否存在、路径是否正确。清浏览器缓存，Ctrl+F5强制刷新。升级PbootCMS后旧JS缓存可能和新版本不兼容，清缓存解决。
验证码显示但一直提示错误，可能是session冲突。多个PbootCMS站点在同一浏览器登录，session互相覆盖。关闭其他站点的后台标签页，清浏览器cookie，重新打开登录页。或者用浏览器无痕模式登录，排除cookie干扰。服务器时间不准也可能导致session过期过快，执行`ntpdate ntp.aliyun.com`同步时间。
字体文件缺失导致验证码显示为叉或空白。部分PbootCMS版本验证码用了自定义字体，字体文件在`static/fonts/`或`apps/admin/view/default/fonts/`下。检查字体文件是否存在，缺失的话从安装包重新上传。或者修改验证码配置，不用自定义字体用默认字体。config.php里找验证码相关配置，关闭字体设置。
PbootCMS新版本可能关闭了验证码。后台"系统配置"→"安全设置"里有后台登录验证码开关，确认是开启状态。如果后台登不进去没法开，直接改数据库：找到`ay_config`或`ay_system`表，找验证码开关的配置项，值设为1。或者临时在代码里注释掉验证码验证，登录后再在后台开启。
更新时间：2026-08-26 17:48:06