跳到主要内容
版本:2.x

故障排查

如果 Flarum 没有按照预期那样安装或工作,您 首先应该检查 服务器环境是否符合 系统要求。 如果您缺少一些 Flarum 运行所需的东西,请先补全内容。

然后,请花几分钟时间搜索 支持论坛问题跟踪器,有可能该问题已被报告,并且有了解决办法。 有可能已经有人报告了该问题,而且修复方案已经可用或正在开发中。 如果您彻底搜索后,仍然没有找到任何有用的信息,那么就可以开始排查故障了。

步骤 0:开启调试模式

在生产环境下跳过

这些调试工具非常有用,但可能会暴露不应公开的信息。 如果你在暂存或开发环境中,这些是可以的。但是如果你不知道你在做什么,那么请在生产环境中跳过这个步骤。

在继续前,您应当启用 Flarum 的调试模式。 用文本编辑器打开 config.php,将 debug 的值改为 true,然后保存文件即可。 开启后,Flarum 会显示详细的错误报告,方便您了解到底发生了什么。

如果上面的改动不起任何作用,并且论坛所有页面都变成空白,请试试将 php.ini 文件中的 display_errors 设置为 On

步骤 1:常见问题修复

很多问题都可通过以下解决:

  • 清除浏览器缓存。
  • 使用 php flarum cache:clear 清除后端缓存。
  • 确保以使用 php flarum migrate 更新数据库。
  • 确保 邮箱配置 可用:无效的邮箱配置将导致注册、重置密码、更换用户绑定邮箱以及发送通知时产生错误。
  • 检查 config.php 配置是否正确,请确保您使用了正确的 url。 例如,请确保正在使用正确的 URLhttpshttp 或大小写敏感之类的,这很重要!)
  • 罪魁祸首还可能是自定义页眉、自定义页脚或自定义 LESS。 如果你的问题在前端,请尝试通过删除管理员仪表板中外观页面的设置。

您也得看看 php flarum info 的输出,以确保没有什么大的问题。

步骤 2:问题重现

请尝试让问题重现。 注意问题发生时,您在做什么? 是每次都会出现问题,还是仅偶尔出现? 尝试调整您觉得可能影响问题出现的设置或参数,或者改变您的操作顺序看看。 问题是否在某些情况下会出现,而在某些情况下又不会出现?

如果您最近安装或更新了一个扩展程序,请暂时禁用它,然后看看问题有没有消失。 请确保您启用的所有扩展程序兼容您使用的 Flarum 版本。 过时的扩展会导致各种各样的问题。

在这个过程中,您可能会发现导致问题的原因,并找到了解决办法。 即便没有,您也可能会得到一些有价值的线索,您最好在报告中填写好这些信息,这将帮助我们弄清楚出了什么问题。

步骤 3:收集信息

如果您无法解决问题,需要他人的帮助,那么就是时候认真收集数据了。 请从这些地方搜集相关报错内容或其他与问题有关的信息:

  • 论坛页面上显示的报错
  • 浏览器控制台中显示的报错(Chrome:更多工具 -> 开发者工具 -> Console)
  • 服务器错误日志中记录的内容(例如:/var/log/nginx/error.log
  • PHP-FPM 错误日志中记录的内容(例如:/var/log/php7.x-fpm.log
  • Flarum 日志记录的报错(storage/logs/flarum.log

将收集到的所有信息复制到记事本中,整理好并做一些注解,比如错误是 何时 发生的、当错误发生时您在 做什么、您探索出来的问题发生和不发生的条件。 请务必附加上你已经知道的关于问题复现条件的信息。 请尽可能详尽地提供服务器环境信息,如操作系统版本、Web 服务器版本、PHP 版本和处理程序等。

步骤 4:准备报告

竭尽所能收集相关问题的所有信息后,您就可以提交错误报告了。 提交时请遵循 提交 Bug 的有关说明。

如果您在提交报告后有发现新的情况,请添加到您的原始帖子底部。 倘若您已经自行解决了问题,也最好提交一份报告,说不定能帮助到遇到同样问题的其他用户。 如果您找到了临时的解决办法,也请告诉我们。