常见问题按主题归组：启动与配置、模板与标签、后台与面板、插件与上传、证书与缓存。多数问题都能按先查配置口径、再看生效时间、最后看日志的顺序定位，各组的排查路径整理如下。
启动时提示端口被占用不必手工处理，程序会自动检测并查杀占用进程后继续启动；需要更换端口在对应配置节修改，保存后自动重启生效。数据库类型切换后需重启程序，库不存在时部分方言自动创建；实际连接数翻倍问题已按双池合计值口径修复，按合计值重新配置并确保小于数据库的最大连接数。
日志出现无效连接提示时，检查数据库空闲回收时间是否大于程序侧的空闲超时，回收过快的数据库会先行断开空闲连接。初始化数据库会清理同前缀的旧表，操作前务必确认备份完好；迁移站点时按新前缀初始化后导入数据，再核对站点配置与域名绑定，避免出现空站点或串站。
模板或样式修改后未生效，先确认资源缓存策略与引用版本参数，再检查模板缓存开关；单页模板按页面字段、单页代码同名文件、通用模板的顺序匹配，把模板命名为单页代码即可自动生效。标签不输出数据时依次检查：字段前缀是否与循环匹配、参数值是否使用双引号、栏目与站点编号是否存在、条件写法是否正确。
排序字段不在白名单时不会报错，只回退为默认顺序；标签云或列表显示异常时，先确认排序字段属于对应对象的真实字段。栏目页内容为空且存在子栏目时会按聚合规则展示子栏目内容，这是预期行为；若希望只显示自身内容，在列表标签上显式关闭包含子栏目即可。
后台部分页面需要登录是资源保护在生效，误伤公共资源时把路径加入公开白名单；面板登录被锁定等待锁定时长后重试，或修改失败限制与锁定时长；密钥丢失时直接修改面板密钥即可重置。双层后台并存期间，功能覆盖以新版为准、旧版保留完整入口，两者操作的是同一份数据。
证书申请失败先检查域名解析、验证路径可达性与测试环境开关；续签未执行查看巡检记录与开关状态。数据更新滞后注意查询缓存与系统统一缓存的过期时间，必要时在缓存管理页手动清理；缓存管理页同时提供查询标签结果缓存的查看与清理入口。
缓存清理页按模块分组展示：系统配置统一缓存、查询缓存与查询标签结果缓存各自可以单独清理；清理命中即失效，不需要重启程序，清理后再次访问页面即可看到最新数据。
常见问题的排查顺序可以固化为三步：确认配置是否按正确口径填写、确认改动是否已到生效时间、查看日志是否给出明确原因。三步走完仍未定位的问题，再带着日志与复现步骤进一步求助，效率最高。
评论
加载中...