删除编译缓存，保留目录结构

杰奇CMS升级后模板不兼容，应先清理编译缓存并开启调试定位报错，再做标签兼容映射；同步优化章节分表、索引、缓存及移动端适配，避免修复模板后被慢查询拖垮。

杰奇CMS升级后模板不兼容的排查与性能优化手册

杰奇CMS升级后模板不兼容,通常不是单纯“模板文件长得不对”，而是旧模板标签在升级后作用域被重置、变量未注入或缓存未刷新，表现为小说站首页正常、列表页白屏、阅读页标签报错、章节内容加载超过3秒，处理顺序应当是：先清缓存开启调试确定报错点，再做标签兼容映射，随后同步做分表、索引、缓存和移动端适配，否则只修模板也会被慢查询继续拖垮，下面按站点实际场景直接给方案和代码。

升级后模板不兼容的快速排查

先清模板编译缓存

杰奇CMS会把模板编译成PHP缓存文件,升级后如果缓存目录残留旧版本编译文件，最容易出现“后台模板改了没反应”“新标签不生效”“白屏”等假故障。

rm -rf /www/wwwroot/site/cache/compiled/*

也可以到后台“系统设置 - 缓存管理 - 更新模板缓存”。

删除编译缓存，保留目录结构

开启调试模式确定报错位置

在 configs/config.php 或 include/common.php 中临时开启调试：

define('JIEQI_DEBUG', true);
error_reporting(E_ALL);
ini_set('display_errors', 'On');

刷新阅读页,根据报错文件定位是模板标签未定义，还是数据库字段不存在，定位完成后及时关闭，不要长期暴露报错。

旧标签兼容层

升级后常见问题是旧模板中 {? $articlename ?}、{? $author ?}、{? $lastchapter ?} 不再输出，原因是新版不再把文章字段直接注册为模板作用域变量，可以在文章模块公共函数中统一注入：

function tpl_article_vars($article) {
    if (empty($article)) return;
    foreach ($article as $k => $v) {
        $GLOBALS[$k] = $v;
    }
}

在阅读页控制器加载文章后调用 tpl_article_vars($article);，旧模板标签就能继续使用，模板中若需要更稳定的写法，建议直接改为：

{? echo isset($article['articlename']) ? $article['articlename'] : '' ?}

这样避免依赖全局作用域,后续再升级也不容易失效。

网站访问速度慢怎么优化

升级后如果模板标签做了大量兼容判断,站点渲染压力会增加，速度优化从 PHP 编译缓存、数据缓存、SQL 精简三个方向做。

开启 OPcache

修改 php.ini：

opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.revalidate_freq=60

改完重启 PHP-FPM 或 Apache。

开启页面缓存

杰奇CMS后台可设置首页、列表页缓存时间，手动配置缓存一般位于 configs/cache.php，小站可用文件缓存：

return array(
    'type' => 'file',
    'path' => '/www/wwwroot/site/cache/data',
    'prefix' => 'jieqi_',
    'expire' => 600,
);

大站建议直接换 Redis：

return array(
    'type' => 'redis',
    'host' => '127.0.0.1',
    'port' => 6379,
    'password' => '',
    'prefix' => 'jieqi_',
    'expire' => 600,
);

改完缓存配置后,先删除旧文件缓存，避免新旧缓存混用造成页面异常。

列表页减少 SQL 查询

列表页只查必要字段：

SELECT articleid, articlename, author, sortid, lastchapterid, lastchapter, updatetime
FROM jieqi_article
WHERE display = 1
ORDER BY articleid DESC
LIMIT 20;

不要使用 SELECT *，尤其不要在列表页模板中循环查询最新章节表。

章节表过大怎么分表处理

小说站阅读量上来后,jieqi_article_chapter 单表几百万行很常见，升级后读章节会明显变慢，甚至拖垮整站。

按 articleid 取模分表

先创建 10 张结构相同的分表：

CREATE TABLE jieqi_article_chapter_0 LIKE jieqi_article_chapter;
CREATE TABLE jieqi_article_chapter_1 LIKE jieqi_article_chapter;
-- 一直到 _9

迁移数据：

INSERT INTO jieqi_article_chapter_0
SELECT * FROM jieqi_article_chapter WHERE MOD(articleid, 10) = 0;
INSERT INTO jieqi_article_chapter_1
SELECT * FROM jieqi_article_chapter WHERE MOD(articleid, 10) = 1;
-- 依次执行到 _9

迁移完成后核对总数：

SELECT
(SELECT COUNT(*) FROM jieqi_article_chapter_0) +
(SELECT COUNT(*) FROM jieqi_article_chapter_1) +
-- 中间相加
(SELECT COUNT(*) FROM jieqi_article_chapter_9) AS total;

确认无误后,将原表改名备份，后续写入走分表逻辑。

PHP 端选择分表

在章节读写函数中按文章ID取模：

function get_chapter_table($articleid) {
    $mod = $articleid % 10;
    return 'jieqi_article_chapter_' . $mod;
}
$sql = "SELECT chapterid, chaptername, content, updatetime
        FROM " . get_chapter_table($articleid) . "
        WHERE articleid={$articleid} AND chapterid={$chapterid}
        LIMIT 1";

如果暂时不想改业务代码,可先用 MySQL 视图或分区表过渡，但长期建议应用层分表。

索引必须加对

分表后每张表保留联合索引：

ALTER TABLE jieqi_article_chapter_0 ADD INDEX idx_article_chapter (articleid, chapterid, display);
ALTER TABLE jieqi_article_chapter_0 ADD INDEX idx_update (updatetime);

不要给 content 长文本字段建普通索引，否则写入会变慢，索引体积也会暴涨。

阅读页加载卡顿怎么改善

阅读页卡顿通常由三类问题造成：查询章节内容时全表扫、同步加载过多无关模块、移动端没有裁剪广告和推荐。

只查当前章

阅读页不要一次性把整本书所有章节查出来,只读当前 chapterid 的内容：

$sql = "SELECT chapterid, chaptername, content, updatetime
        FROM " . get_chapter_table($articleid) . "
        WHERE articleid={$articleid} AND chapterid={$chapterid}
        LIMIT 1";

// 下一章
SELECT chapterid, chaptername
FROM jieqi_article_chapter_x
WHERE articleid={$articleid} AND chapterid > {$chapterid}
ORDER BY chapterid ASC LIMIT 1;
// 上一章
SELECT chapterid, chaptername
FROM jieqi_article_chapter_x
WHERE articleid={$articleid} AND chapterid < {$chapterid}
ORDER BY chapterid DESC LIMIT 1;

异步加载非核心内容

评论区、相关推荐、榜单、书签状态全部改成 AJAX 加载，阅读页模板只渲染正文和上一章/下一章链接，首屏加载速度会明显提升。

内容字段分离

如果章节表已经分表,仍建议将 content 与其他轻量字段拆开：

CREATE TABLE jieqi_article_chapter_content_0 (
    chapterid INT UNSIGNED NOT NULL,
    content MEDIUMTEXT,
    PRIMARY KEY (chapterid)
) ENGINE=InnoDB;

列表查询不读 content，阅读页再单独查询或关联，减少扫描开销。

模板标签调用和修改方法

定位旧标签失效位置

录,搜索类似 {? $articlename ?}、{? $author ?}、{? $sortname ?} 的标签，杰奇模板常见用输出变量，升级后要确认变量是否还存在。

统一替换变量写法

如果旧标签大量失效,建议用脚本批量替换：

$dir = 'themes/你的主题/';
$files = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir));
foreach ($files as $file) {
    if ($file->isFile() && $file->getExtension() == 'html') {
        $path = $file->getPathname();
        $str = file_get_contents($path);
        $str = str_replace(
            array('{? $articlename ?}', '{? $author ?}'),
            array('{? echo isset($article[\'articlename\']) ? $article[\'articlename\'] : \'\' ?}', '{? echo isset($article[\'author\']) ? $article[\'author\'] : \'\' ?}'),
            $str
        );
        file_put_contents($path, $str);
    }
}

执行前务必备份主题目录。

新模板建议直接读数组

新主题不要再依赖全局变量,统一使用 $article['字段']、$chapter['字段']，循环列表时：

{? foreach ($articlelist as $row) { ?}
    <a href="...">{? echo $row['articlename'] ?}</a>
{? } ?}

这样升级后更不容易受模板作用域影响。

移动端适配怎么处理

升级后旧PC模板可能没有 viewport，移动端阅读体验差，甚至页面横向溢出。

强制移动端视口

在主题 header.html 中加：

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">

CSS 改为相对单位：

.read-content { font-size: 1rem; line-height: 1.8; word-break: break-all; }

按 UA 切换移动端主题

在入口公共文件判断：

function is_mobile() {
    $ua = isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : '';
    return preg_match('/(android|iphone|ipod|mobile|ucbrowser|micromessenger)/i', $ua);
}
if (is_mobile()) {
    define('JIEQI_THEME', 'mobile'); // 按你的主题目录名
}

旧模板兼容期间可让移动端使用独立精简主题,PC端仍走旧模板，避免升级后移动端布局错乱。

缓存配置怎么设置

模板缓存

模板缓存目录要可写,升级后先清空：

chmod -R 755 cache
find /www/wwwroot/site/cache -type f -name "*.php" -delete

数据缓存时间

建议按页面类型设置：

首页缓存 300 秒；
列表页缓存 600 秒；缓存 1800 秒；
搜索页不缓存或缓存 60 秒。

如果使用 Redis，键名加版本号，升级后强制刷新：

$cache->set('jieqi:article:' . $articleid . ':' . $chapterid, $content, 1800);

模板升级后一定要把旧缓存键清理,否则会继续读旧模板渲染结果，误以为模板不兼容还没修好。

数据库定期维护清理建议

升级后容易积压无效数据、日志和草稿，导致表膨胀，查询变慢。

清理无效数据

DELETE FROM jieqi_article_chapter
WHERE articleid NOT IN (SELECT articleid FROM jieqi_article);
DELETE FROM jieqi_article_bookcase
WHERE articleid NOT IN (SELECT articleid FROM jieqi_article);
DELETE FROM jieqi_session
WHERE updatetime < UNIX_TIMESTAMP(NOW()) - 86400 * 7;

大表执行删除时建议分批提交,避免锁表时间过长。

优化表碎片

OPTIMIZE TABLE jieqi_article_chapter;
OPTIMIZE TABLE jieqi_article;

大表不要频繁 OPTIMIZE，建议每月做一次，并在低峰执行。

定时任务脚本

创建 cron/cleanup.php：

<?php
define('JIEQI_APP_TYPE', 'cron');
require_once dirname(__DIR__) . '/include/common.php';
$db->query("DELETE FROM jieqi_session WHERE updatetime < UNIX_TIMESTAMP(NOW()) - 86400 * 7");
$db->query("DELETE FROM jieqi_article_draft WHERE addtime < UNIX_TIMESTAMP(NOW()) - 86400 * 30");
$db->query("OPTIMIZE TABLE jieqi_article_chapter");
echo "cleanup done\n";

配置 crontab：

0 3 * * * php /www/wwwroot/site/cron/cleanup.php >> /var/log/jieqi_cleanup.log 2>&1

升级后第一个月建议每周跑一次,后续每月跑一次。

杰奇CMS升级后模板不兼容的处理不能只停留在替换标签,正确顺序是：先清空模板缓存和调试定位，再建兼容层批量替换旧标签；随后顺手处理章节分表、阅读页查询瘦身、缓存策略和移动端适配，最后用定时任务控制表体积，这样既能解决升级后的白屏、错位，也能避免“模板修好了但站变慢”的二次故障。

正文

删除编译缓存，保留目录结构

升级后模板不兼容的快速排查

先清模板编译缓存

开启调试模式确定报错位置

旧标签兼容层

网站访问速度慢怎么优化

开启 OPcache

开启页面缓存

列表页减少 SQL 查询

章节表过大怎么分表处理

按 articleid 取模分表

PHP 端选择分表

索引必须加对

阅读页加载卡顿怎么改善

只查当前章

异步加载非核心内容

内容字段分离

模板标签调用和修改方法

定位旧标签失效位置

统一替换变量写法

新模板建议直接读数组

移动端适配怎么处理

强制移动端视口

按 UA 切换移动端主题

缓存配置怎么设置

模板缓存

数据缓存时间

数据库定期维护清理建议

清理无效数据

优化表碎片

定时任务脚本

相关阅读

删除编译缓存，保留目录结构

宝塔面板文件上传大小限制怎么改？新手高频问题一次讲透

亚太CDN新西兰测速，促销季三款特价套餐与价格对比

或者

目录[+]