常见问题
常见问题排查
安装与访问
首页 404 或除首页外全部 404
伪静态未生效。检查 Nginx try_files 或 Apache mod_rewrite,确认 .htaccess 被允许读取。
后台登录提示“页面已过期”
Session 目录不可写或浏览器禁用了 Cookie。检查 PHP session.save_path,并确认访问域名与 config.app.session 配置一致。
上传失败
| 现象 | 排查 |
|---|---|
文件上传失败(错误码 1) | 超过 PHP upload_max_filesize |
文件保存失败 | assets/uploads 或 storage 无写权限 |
| 仅允许上传 jpg… | 扩展名不在白名单,检查文件真实格式 |
文章正文显示原始 Markdown
说明前台未走 Markdown 渲染。确认文章详情由内容控制器渲染,且 core/Markdown.php 存在;历史 HTML 正文会自动识别并原样输出。
标签不输出内容
按顺序检查:
- 标签名与闭合是否正确。
- 栏目 ID 是否存在、栏目是否启用。
- 内容是否发布(
status=1)。 - 插件标签依赖的插件是否启用。
- 清理 cms 模板缓存。
支付回调未生效
- 确认
notify_url可从公网访问。 - 检查易支付商户号与密钥。
- 查看
storage/logs中回调记录与签名校验结果。 - 订单状态只在验签通过后更新。
升级补丁为空
新旧版本文件完全一致时不会产生差异。确认版本号已提升且文件内容确实变更。
开发者上传被拒绝
先完成开发者认证,认证通过后 cert_status=1 才能上传;应用审核通过后才会出现在市场。
已是第一篇 已是最后一篇