故障排查

如果在使用 MrDoc 觅思文档的过程中，出现了未知的异常和报错，但是找不到原因，可以通过如下方式进行故障排查。

## 零、擅用翻译和搜索

对于一些报错的英文信息，要善于利用:

- 翻译软件（百度翻译 https://fanyi.baidu.com/ 、有道翻译https://fanyi.youdao.com/index.html#/ ）
- 搜索引擎（百度 https://www.baidu.com 、必应 http://www.bing.com 、谷歌 http://www.google.com）

对报错信息进行认识和解决方法的获取。

如果无法通过搜索引擎获取解决方法，可以按照下述方法，获取详细的报错信息后进行反馈。

## 一、开启调试

在配置文件中开启`debug`调试，当页面出现异常时，会输出详细的错误信息。

配置文件详见：https://doc.mrdoc.pro/doc/3990/

## 二、查看浏览器调试控制台

在浏览器出现异常的页面上，鼠标右键选择「检查」，会打开浏览器的调试控制台。

你可以在「控制台」选项卡中查看有无错误信息输出：

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/04/20/2023-04-20_104458_2624190.9230515041405257.png)

也可以在「网络」选项卡中找到异常相关的请求，点击请求的 URL 查看其响应情况：

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/04/20/2023-04-20_104643_6248900.054060900972025094.png)

## 三、查看日志

你还可以通过查看日志来了解故障的原因。

MrDoc 日志查看详见：https://doc.mrdoc.pro/doc/45444/

## 四、故障反馈模板

如果你需要将故障进行反馈以寻求帮助，为了节约大家的时间，请务必提供完整详细的信息，包括但不限于：

0.部署方式是什么？

请详细提供部署方式涉及的所有系统信息，包括操作系统、是否使用了宝塔面板、是否使用了Docker部署、Docker镜像版本等等。

1.当前的 MrDoc 版本是什么？

2.使用的数据库是什么？

3.出现问题的页面路径是什么？

4.出现问题的操作流程是什么？

5.出现的问题是否能够复现？

6.出现的问题是单一的还是普遍的？

7.使用的浏览器版本是什么？

8.如果有日志，请提供日志

9.如果有复现截图，请提供截图

10.如果有复现视频，请提供视频

11.如果问题对象是文集，提供文集信息

12.如果问题对象是文档，提供文档信息