迅睿CMS后台验证码失效 从零开始一步步实操修复指南

一、先确认故障适用范围

你可以先对照以下场景，确认你的问题符合本文修复范围：

• 后台登录页验证码不显示、显示红叉或空白块
• 验证码能显示，但输入正确内容仍然提示「验证码错误」
• 已经清除过网站缓存、重置过配置仍然无法解决

二、第一步：排查PHP环境基础配置

超过90%的验证码失效问题都是环境配置错误导致，先完成这两步排查：

2.1 检查GD图形扩展是否正常开启

迅睿CMS验证码依赖GD扩展生成图形，未开启扩展必然失效，操作方法：

• 在网站根目录新建文件，命名为 info.php，写入以下内容：

```php ```

• 保存后访问「你的域名/info.php」，页面搜索关键词「gd」，如果搜索不到结果，说明扩展未开启，按对应场景开启：

宝塔面板用户操作：打开软件商店 → 找到当前使用的PHP版本 → 点击「设置」→ 切换到「安装扩展」→ 找到GD扩展点击安装，安装完成后重启PHP即可。

原生LNMP环境用户操作：进入PHP源码目录的ext/gd文件夹，执行以下命令编译安装：

```bash ./configure --with-php-config=/usr/local/php/bin/php-config make && make install ```

编译完成后，打开php.ini文件，添加一行extension=gd.so，保存后重启PHP-FPM和Nginx。

2.2 检查Session存储目录权限

验证码的验证信息存储在Session中，目录不可写会导致验证失败，操作方法：

打开php.ini搜索session.save_path，找到Session存储路径，然后执行权限设置命令：

```bash chmod 733 /你的session存储路径 chown www:www /你的session存储路径 ```

如果是虚拟主机用户，Session默认路径是网站根目录下的tmp文件夹，直接将tmp文件夹权限设置为755，没有该文件夹就手动新建一个。

三、第二步：修复迅睿CMS核心配置错误

环境确认正常后，接下来修正迅睿本身的配置问题：

3.1 修正Cookie域名配置

域名配置不匹配会导致Session无法正常读取，打开网站根目录下的config/domain.php，直接复制以下内容替换原文件内容，再替换成你自己的信息：

```php '你的主域名', // Cookie域名，带前缀点，例如 .example.com，同时支持www和非www 'cookie_domain' => '.你的主域名', // 开启HTTPS填1，未开启填0 'is_https' => 1, ]; ```

3.2 修正验证码参数配置

打开网站根目录下的config/website.php，找到验证码配置段，确认参数和下文一致，如果没有就添加到return [数组内部：

```php // 验证码配置 'captcha' => [ 'width' => 120, 'height' => 40, 'length' => 4, 'fontsize' => 20, 'admin_enable' => 1, ], ```

3.3 确认后台入口文件启动Session

网站迁移后经常会丢失入口文件的Session启动代码，打开网站根目录下的admin.php，确认开头代码和下文一致，缺失就补上：

```php 四、第三步：排查CDN缓存规则问题

使用CDN加速的网站，经常因为缓存规则错误把验证码接口当成静态资源缓存，导致失效，操作：

• 登录CDN服务商控制台，找到缓存规则设置，添加排除规则：将路径/api/captcha/设置为不缓存
• 清除CDN全网缓存，再清除本地浏览器缓存

五、修复完成验证步骤

• 删除根目录下之前新建的info.php，避免泄露服务器信息
• 登录迅睿CMS后台，进入「系统 → 缓存更新 → 更新全部缓存」
• 打开浏览器无痕模式访问后台登录页，查看验证码是否正常显示
• 输入正确验证码尝试登录，登录成功说明修复完成

如果按照以上步骤操作后仍然无法解决，可以将每一步的排查结果截图，到迅睿官方论坛提交问题即可获得进一步支持。