第四十四章 提示与错误速查
排障先抄屏幕原文再查表:前台、后台登录、后台操作、模板与缓存、短信与外部服务的原文对照,以及报障要带的三样。
怎么读这张表
排障最省时间的顺序是:先抄屏幕原文,再查这张表,最后才动文件。同一个现象可能由好几层造成,比如「页面空白」既可能是模板坏了,也可能只是缓存没清;先按原文定位到层,能少走一大半弯路。
表里的「原文」是程序或浏览器真正显示给你的字,标点、空格都照抄。原文对不上时不要硬套,先看是不是浏览器自己弹的提示(比如「无法访问此网站」属于连接层,不是 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) | 运营商侧拦截,不是本站错误 | 换号测试;确认不是退订或投诉名单;见第二十五章 |
模板变量不匹配类报错 | 模板内容与提交的变量名对不上 | 验证码模板只能走验证码通道,通知模板变量要按模板实际占位符填;见第二十五章 |
| 提示余额不足或发送频率超限 | 阿里云账户或号码级限制 | 看短信配置页顶部的余量与到期提示;见第二十五章 |
| 升级栏一直提示「暂时没连上厂商的升级服务」 | 服务器出网失败或厂商服务不可达 | 先确认服务器能出网,再重试检查;见第三十八章 |
报障要带的三样
- 时间:精确到分钟,并说明是北京时间。日志按服务器时间写,时区不一致会把线索对错。
- 完整地址:从
http://开始到?后面的参数,别只给「那个页面」。 - 屏幕原文:截图或逐字抄,包括状态码(404/403/500)。有堆栈时把第一行与最后一行一起给。
后台能打开时,再附两处记录:设置 → 错误记录(运行期错误),设置 → 操作日志(谁在什么时候改了什么,筛选类型「拦截」可看被拒的写操作)。数据库层面的连接失败另外写在服务器 log/db_年月日.log 里,这个目录不允许通过网址访问,需要到服务器上取。
不要为了「让页面先能打开」去删库文件、改表结构或直接替换 lib/ 下的核心文件。这类操作会把一条可查的错误变成一片查不出的空白,而且很难回滚。
接下来怎么读
- 要按现象走完整排查路径:第四十章。
- 要理解缓存为什么让人误判:第三十三章。
- 要核对某个菜单在哪:第四十三章。
微信扫码聊需求