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