故障排查

如果 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 配置正确，根据实际情况填写 https 或 http 协议头。
• 检查自定义页眉、自定义页脚，或自定义 LESS 的语法格式。如果由前端引发，请在后台一一删除这些代码，排查错误来源。

别忘了查看 php flarum info 命令的输出，确保没有遗漏重要信息。

步骤 2：问题重现

请尝试让问题重现。注意问题发生时，您点击了什么？尝试调整可能与问题有个的设置或参数，或者改变您的操作顺序。问题是否只在某些情况下出现？出现的频率又是多少？

请暂时禁用最近安装或更新的扩展程序，然后看看问题是否消失。请确保您启用的所有扩展程序兼容您当前使用的 Flarum 版本。过时的扩展程序会存在各种问题。

在这一步，您可能会发现问题产生的原因，并找到解决办法。或者仅仅得到了一些有用线索，请在报告时将这些信息提供给我们，这有助于查清问题根源。

步骤 3：收集信息

如果您需要他人的帮助，请搜集以下报错内容或其他与问题有关的信息：

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

整理收集的信息，并进行相应的注解，比如错误 何时何地 发生、因 何操作 发生，您探索出来的发生条件。请详尽提供服务器环境信息，如操作系统版本、Web 服务器版本、PHP 版本等。

步骤 4：准备报告

信息一旦整理完毕，就可以提交报告了。提交时请遵循 提交 Bug 文档的相关说明。

在提交报告后如有新发现，请在议题中跟帖。若您自行解决了问题、或发现了临时解决办法，也最好阐述一下解决办法，帮助遇到同样问题的用户。