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

## 零、擅用翻译和搜索

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

- 翻译软件（百度翻译 https://fanyi.baidu.com/ 、有道翻译https://fanyi.youdao.com/index.html#/ ）
- 搜索引擎（百度 https://www.baidu.com 、必应 http://www.bing.com 、谷歌 http://www.google.com）
- AI智能助手（Deepseek https://chat.deepseek.com/ 、豆包 https://www.doubao.com/chat 、ChatGPT https://chatgpt.com/）

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

如果不能解决，可以按照下述方法，获取详细的报错信息后进行反馈。

## 一、开启调试

在配置文件中开启`debug`调试，当页面出现异常时（例如500 Internal Server Error），会输出详细的错误信息。

配置文件详见：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.部署方式是什么？

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

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

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

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

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

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

### 7.使用的操作系统、浏览器版本是什么？

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

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

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

### 11.如果问题对象是文集，提供文集及其配置信息

### 12.如果问题对象是文档，提供文档及其配置信息

### 13.如果问题对象是用户，提供用户信息及站点用户配置信息

### 14.如果问题对象是素材，提供素材和存储相关配置信息

```