杰奇CMS运维手记，七场数据突围战，从报错到丝滑导出的全实录

安装环境检测不通过——"红色叉号"拦路虎

报错现象：
后台安装向导第三屏，PHP版本、MySQL版本、GD库、curl扩展等检测项出现连续红叉，点击“下一步”按钮无响应。
原因分析：
绝大多数情况是PHP版本过旧（低于5.6）或编译时未启用必需扩展，部分虚拟主机默认禁用exec()函数导致环境检测脚本无法获取真实系统状态。
解决步骤：

升级PHP：若在宝塔/面板环境，直接切换至PHP 7.3或7.4（杰奇对PHP7兼容性最佳）；
手动开启扩展：登录php.ini，取消extension=php_gd2.dll、extension=php_curl.dll前的分号注释，保存后重启PHP-FPM；
绕过检测：若主机商锁定php.ini，可在杰奇根目录新建install.lock随意），再访问/install/，系统会跳过环境检测直接进入参数配置阶段，但务必确认基础库已具备。

后台登录异常——验证码不显示或登录后跳回

报错现象：
登录页验证码图片显示为破碎图标，输入正确账号密码后页面刷新但仍在登录框，或提示“验证码错误”却无任何图形。
原因分析：
验证码依赖GD库和Session，若PHP会话目录无写权限，或服务器时间误差过大导致Cookie失效，均会触发此问题。
解决步骤：

杰奇CMS运维手记，七场数据突围战，从报错到丝滑导出的全实录

检查会话权限：执行chmod -R 777 /tmp（或杰奇cache/目录），并修改php.ini中session.save_path为可写绝对路径；
重置时间：使用sudo ntpdate -u pool.ntp.org同步系统时间，并检查php.ini中date.timezone设为Asia/Shanghai；
暴力直通：临时在/config/config.php追加$_SESSION['admin_ok']=1;和$_SESSION['admin_id']=1;（测试后删除），绕过登录校验直接进入后台。

数据库连接失败——“连接数据库服务器失败”

报错现象：
后台或前台页面显示“Can't connect to MySQL server on 'localhost' (10061)”，或SQLSTATE[HY000] [1045] Access denied。
原因分析：
三类原因居多：数据库服务未启动、MySQL密码错误（且系统使用旧式加密）、以及杰奇配置文件中的DB_HOST指向了不可达的远程地址。
解决步骤：

验证本地服务：命令行执行mysqladmin -u root -p ping，如无响应则service mysql start（或/etc/init.d/mysqld start）；
清除加密干扰：执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';并FLUSH PRIVILEGES;；
修正配置：打开/config/database.php，逐一核对db_host、db_user、db_pass、db_name，并将db_port改为3306，若此前未设置则留空。

无法读取——小说阅读页空白或404

报错现象：
书目列表正常显示，点击“开始阅读”后页面提示“资源不存在”或直接跳转首页，但后台章节管理可见内容。
原因分析：
这多因伪静态规则未正确映射章节ID，或数据库中的chapter表缺少content字段（如升级残留），同时也可能是缓存目录堆积旧文件所致。
解决步骤：

重写规则核对：若使用Nginx，确认location /read/中的try_files $uri $uri/ /read.php?$args;已包含chapter参数传递；

数据库修复：

ALTER TABLE `jieqi_chapter` ADD COLUMN `content` MEDIUMTEXT NOT NULL AFTER `chaptertitle`;

若已有字段,则执行REPAIR TABLE jieqi_chapter;；

清理缓存：删除/cache/下所有*.php缓存文件（保留目录），再强制刷新页面。

页面空白或乱码——一片纯白或满屏菱形符号

报错现象：
首页或小说详情页自动输出一堆乱码（中文全变“锟斤拷”），或直接白屏无任何输出。
原因分析：
乱码几乎总是UTF-8与GBK不兼容导致——杰奇默认UTF-8，但数据库或模板文件被转为GBK；白屏则多为PHP解析错误或内存耗尽，且被错误抑制了显示。
解决步骤：

强制编码统一：在/config/const.php（或config.php）追加：
```
header('Content-Type:text/html; charset=utf-8');
mb_internal_encoding('UTF-8');
```
并全站grep -rl 'charset=gb2312' .将所有文件改为utf-8；
打开错误日志：在根目录.htaccess（或Nginx的fastcgi_param）增加php_flag display_errors on，然后后台重试，查看具体错误行——通常为某模板调用了已删除的函数；
内存不足：在config.php中设置ini_set('memory_limit','128M');，并检查是否存在死循环调用。

伪静态规则不生效——所有URL均带?action=

报错现象：
后台开启“全站伪静态”后，前台链接仍显示类似/index.php?action=book&id=12，且状态码200，但URL未重写。
原因分析：
Apache未加载mod_rewrite模块，或Nginx下未在server块中引入杰奇提供的nginx_rewrite.conf；更隐蔽的原因是站内根目录的.htaccess文件遭到权限破坏。
解决步骤：

Apache检查：执行httpd -M | grep rewrite，若无结果则在httpd.conf中启用LoadModule rewrite_module modules/mod_rewrite.so，并确保根目录允许AllowOverride All；

Nginx手动重写：在server{}中加入：

if (!-e $request_filename) {
    rewrite ^/(.*)$ /index.php?/$1 last;
}

然后nginx -s reload；

强制生效：将.htaccess内容替换为杰奇官方提供的规则（内含RewriteRule ^(book|read|search)/(.*)$ index.php?action=$1&$2 [L]），保存后使用文件管理器确认权限为644。

采集模块报错——“采集规则无匹配”或超时

报错现象：
后台“采集管理”中测试采集中，提示“第2行匹配失败”，或采集10分钟后显示“连接超时”，但源站浏览器可打开。
原因分析：
多数因为目标网站返回的HTML不再是正则预期结构（章节标签类名变化），或是PHPallow_url_fopen被禁用，以及服务器与目标站之间的网络节点超时。
解决步骤：

更新规则：进入/admin/collect.php找到对应规则，使用检查元素功能复制章节列表的<ul>结构，在规则中替换preg_match正则的class属性部分（例如把class="list"换成class="chapter-list"）；
开启网络回退：在config.php中设置
```
ini_set('allow_url_fopen', 1);
ini_set('default_socket_timeout', 60);
```
若仍不通,则在采集页面改用“curl模式”（后台单选框切换）；
分批限速：在采集设置里将“每次请求间隔”设为2秒，“单批数量”设为20，避免被源站封IP导致超时。