故障排查

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

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

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

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

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

• 清除浏览器缓存。
• 使用 php flarum cache:clear 清除后端缓存。
• 确保以使用 php flarum migrate 更新数据库。
• 确保 邮箱配置 可用：无效的邮箱配置将导致注册、重置密码、更换用户绑定邮箱以及发送通知时产生错误。
• 检查 config.php 配置是否正确，请确保您使用了正确的 url。

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

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

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

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

如果您无法解决问题，需要他人的帮助，请从这些地方搜集相关报错内容或其他与问题有关的信息：

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

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

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

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