# 故障排查

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

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

# 步骤 1:开启调试模式

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

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

# 步骤 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 的有关说明。

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