第四十四章 提示与错误速查

Ju7CMS 用户手册 · 发布于 2026-10-27 · 更新于 2026-10-27

排障先抄屏幕原文再查表:前台、后台登录、后台操作、模板与缓存、短信与外部服务的原文对照,以及报障要带的三样。

怎么读这张表

排障最省时间的顺序是:先抄屏幕原文,再查这张表,最后才动文件。同一个现象可能由好几层造成,比如「页面空白」既可能是模板坏了,也可能只是缓存没清;先按原文定位到层,能少走一大半弯路。

表里的「原文」是程序或浏览器真正显示给你的字,标点、空格都照抄。原文对不上时不要硬套,先看是不是浏览器自己弹的提示(比如「无法访问此网站」属于连接层,不是 CMS 的提示)。

访客一侧:前台页面

现象屏幕原文常见原因处置与参考
整页空白,状态 200没有文字,查看源码也是空模板编译失败后被静默吞掉;或模板输出为空按第四十章的两分法先判「页面坏还是模板坏」,再清模板缓存
整页 500浏览器错误页,本机可能带详细堆栈页面级 ASP 错误:拼错的函数、未闭合的块、坏令牌看错误记录与 log/ 下的日志;回滚最近改过的模板
整页 500,页面只有一句话系统维护中,请稍后再试数据库连不上、库文件缺失、驱动全部回退失败先确认 data/#Andvar_com.mdb 在不在、能不能读写;见第三章
提示页面未找到页面未找到(404)内容被删、栏目改过目录、地址里的 id 不存在用后台搜标题确认内容是否还在;见第四十章
提示访问受限访问受限(403)IP 或地区被访问限制拦截到「访问限制」核对名单;见第三十七章
提示访问过于频繁访问过于频繁(403)同一来源短时间请求过多,触发限速等待自动解除;确认不是采集或压测
页面能开但没有内容版式正常,列表或正文空内容还是草稿、栏目语言不匹配、模板筛选条件过窄看内容状态与语言;见第十四章、第十六章
改了前台没变化旧内容仍在三层缓存中至少一层没失效按第三十三章逐层排除,不要先改模板

前台出现 500 时不要连续刷新几十次。每次请求都可能再写一条错误记录,真正有用的第一条反而被刷到后面去了。

后台登录

屏幕原文含义处置
用户名或密码错误账号不存在或口令不对,两种情况故意不区分核对大小写;连续失败会触发锁定,见下一行
登录失败次数过多,请15分钟后再试同账号或同来源连续失败 5 次等待 15 分钟;不要换浏览器反复试,锁的是账号与来源
验证码不能为空没填图形验证码填写右侧四位数字
验证码已过期,请点击图片刷新验证码有有效期,超时作废点验证码图换一张再提交
验证码不正确填错或刷新后仍用旧值重新看图再填
本站域名还没有取得授权,请联系服务商开通后再登录当前域名没有授权记录核对访问域名与授权记录;见第三十六章
网站授权已于 … 到期,后台已锁定,请联系服务商续期授权到期,超过宽限期后锁后台续期并重新粘交付串;见第三十六章
服务商那边已经不认本站域名的授权…授权记录被停用或改动,厂商拒绝联系服务商核对域名列表,重新出交付串
现在联系不上服务商的授权服务…厂家校验服务不可达,且本地没有可用票据检查服务器出网;恢复后重试
登录成功但马上回到登录页会话没建立或被销毁确认浏览器允许 Cookie;后台空闲 20 分钟会要求重登,属正常

授权只挡后台,不影响前台展示。前台正常、后台被锁,先查授权,不要去改模板。

后台操作

屏幕原文发生在哪原因与处置
参数错误各类保存、删除接口缺参数、参数类型不对,或记录已被别人删掉;刷新列表后重试
禁止外部提交数据保存、上传、评论等写接口请求不是从本站页面发出(缺同源 Referer 或令牌);从后台页面正常操作即可
…不存在或已被删除账号、栏目、内容、区块、评论、字段记录确实没了,或语言/栏目条件不匹配;先刷新再确认
字段不存在或字段名称非法字段管理字段名只能用小写字母、数字、下划线,且不能与现有列重名
没有文件上传上传接口表单没带上文件,或文件在选择后被移动
文件过大,上传失败上传接口超过上传设置的上限;见第七章
禁止上传此类文件 / 不允许被上传的文件上传接口扩展名不在允许列表;改上传设置前先想清楚风险
文件保存失败上传接口目录没有写权限或磁盘满;检查 upfile/ 权限与剩余空间
密码不能与用户名相同 / 密码不能包含用户名账号管理与改密口令规则:8–18 位,字母与数字都要有,不能含账号名
用户名已存在,请换个试试添加账号换一个登录名;账号名不是显示用的笔名
点按钮没反应,页面也没提示任意后台页先看「操作日志」里最近的「拦截」行;写接口被跨站校验拒绝时,提示可能被响应直接结束吞掉

模板与缓存

屏幕原文含义处置
…:模板文件不存在栏目指定的模板在主题目录里找不到核对栏目「列表模板 / 内容模板」,或到模板管理确认文件在不在;见第三十章
页面 200 但零字节模板阶段就失败了,错误没到页面关闭整页缓存后重开一次,拿到真实错误;见第四十章
页面 500 但内容区已经输出模板后半段(拆卸期)出错重点查模板尾部的内联脚本与未闭合块;见第四十章
改了模板没生效模板编译缓存仍是旧的清模板编译缓存;只改 CSS/JS 则检查版本号有没有升;见第三十三章
改了内容没生效整页缓存仍是旧 HTML清整页缓存,或等缓存到期;见第三十三章
浏览器里还是旧的浏览器缓存强刷;HTML 文档已设为不缓存,静态资源按 7–30 天缓存

短信与外部服务

屏幕原文含义处置
验证码已发送正常,短信已交给运营商没收到时先等 1 分钟,再看手机是否拦截了营销短信
本地|验证码模板未配置验证码模板 ID 为空到表单字段编辑页填「验证码模板ID」;见第二十章
手机号在黑名单(GB:0011)运营商侧拦截,不是本站错误换号测试;确认不是退订或投诉名单;见第二十五章
模板变量不匹配类报错模板内容与提交的变量名对不上验证码模板只能走验证码通道,通知模板变量要按模板实际占位符填;见第二十五章
提示余额不足或发送频率超限阿里云账户或号码级限制看短信配置页顶部的余量与到期提示;见第二十五章
升级栏一直提示「暂时没连上厂商的升级服务」服务器出网失败或厂商服务不可达先确认服务器能出网,再重试检查;见第三十八章

报障要带的三样

  1. 时间:精确到分钟,并说明是北京时间。日志按服务器时间写,时区不一致会把线索对错。
  2. 完整地址:从 http:// 开始到 ? 后面的参数,别只给「那个页面」。
  3. 屏幕原文:截图或逐字抄,包括状态码(404/403/500)。有堆栈时把第一行与最后一行一起给。

后台能打开时,再附两处记录:设置 → 错误记录(运行期错误),设置 → 操作日志(谁在什么时候改了什么,筛选类型「拦截」可看被拒的写操作)。数据库层面的连接失败另外写在服务器 log/db_年月日.log 里,这个目录不允许通过网址访问,需要到服务器上取。

不要为了「让页面先能打开」去删库文件、改表结构或直接替换 lib/ 下的核心文件。这类操作会把一条可查的错误变成一片查不出的空白,而且很难回滚。

接下来怎么读

  1. 要按现象走完整排查路径:第四十章。
  2. 要理解缓存为什么让人误判:第三十三章。
  3. 要核对某个菜单在哪:第四十三章。