Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit 7566b36

Browse files
author
astrbot-docs-agent[bot]
committed
docs: update for AstrBotDevs/AstrBot#5376
1 parent 7f682f5 commit 7566b36

2 files changed

Lines changed: 26 additions & 0 deletions

File tree

en/faq.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,19 @@ This is because the provider's API returned empty text. Try the following steps:
5454
5. Lower the maximum conversation count setting
5555
6. Switch to another model from the same provider / a different provider
5656

57+
### Startup Error: `JSONDecodeError: Unexpected UTF-8 BOM`
58+
59+
On Windows, some text editors (like Notepad) automatically add a UTF-8 BOM (Byte Order Mark) when saving JSON files, causing AstrBot to fail to start.
60+
61+
**Solutions:**
62+
63+
1. Use an editor that supports UTF-8 without BOM (such as VS Code, Notepad++) to open the configuration file
64+
2. When saving, select "UTF-8" encoding (without BOM)
65+
3. Or modify configurations directly in the AstrBot WebUI to avoid manually editing JSON files
66+
67+
> [!NOTE]
68+
> AstrBot has added compatibility handling for UTF-8 BOM in newer versions. It is recommended to update to the latest version to avoid this issue.
69+
5770
## Plugin Related
5871

5972
### Cannot Install Plugin

zh/faq.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,19 @@
7171
5. 降低最大对话次数设置
7272
6. 切换使用同一供应商的其他模型,或不同供应商的模型
7373

74+
### 启动时报错 `JSONDecodeError: Unexpected UTF-8 BOM`
75+
76+
在 Windows 系统上,某些文本编辑器(如记事本)保存 JSON 文件时会自动添加 UTF-8 BOM(字节顺序标记),导致 AstrBot 无法正常启动。
77+
78+
**解决方法:**
79+
80+
1. 使用支持无 BOM 编码的编辑器(如 VS Code、Notepad++)打开配置文件
81+
2. 另存为时选择 "UTF-8" 编码(不带 BOM)
82+
3. 或者直接在 AstrBot WebUI 中修改配置,避免手动编辑 JSON 文件
83+
84+
> [!NOTE]
85+
> AstrBot 已在新版本中增加了对 UTF-8 BOM 的兼容处理,建议更新到最新版本以避免此问题。
86+
7487
## 插件相关
7588

7689
### 插件安装不上

0 commit comments

Comments
 (0)