故障排查

如果 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。 例如，请确保正在使用正确的 URL（https 与 http 或大小写敏感之类的，这很重要！）
• 罪魁祸首还可能是自定义页眉、自定义页脚或自定义 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 的有关说明。

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