如何修复MongoDB Compass出现的BSON编码Invalid UTF-8字符串报错

该报错核心是MongoDB Compass的BSON解析模块读取到了非UTF-8编码的字符，触发严格校验报错，和你推测的系统层面问题一致，具体诱因如下：

• Windows系统当前登录用户名包含中文、特殊符号等非ASCII字符：Compass默认会在用户目录C:\Users\你的用户名\AppData下存储配置、缓存文件，中文用户名会导致路径包含GBK编码的字符，BSON解析时会判定为无效UTF-8字符串。
• 系统区域编码未启用UTF-8：Windows 10中文系统默认使用GBK作为系统编码，Compass读取系统环境变量、路径参数时，非UTF-8编码的内容无法通过BSON的编码校验。
• 旧版本Compass缓存残留：重装时未彻底删除AppData目录下的异常缓存文件，导致错误配置持续生效。

按优先级从高到低尝试即可：

1. 修改Compass数据存储路径（无系统级副作用，优先尝试）
   先在纯英文路径下新建一个文件夹，例如C:\MongoDBCompassCache，右键点击MongoDB Compass的桌面快捷方式，选择「属性」，在「目标」输入框的原有内容末尾，添加空格后输入以下参数：
   --user-data-dir="C:\MongoDBCompassCache"
   点击「确定」保存后，重新通过该快捷方式启动Compass即可。
2. 启用Windows UTF-8系统编码
   打开系统「设置」→「时间和语言」→「语言」→「管理语言设置」→「更改系统区域设置」，勾选「Beta版：使用Unicode UTF-8提供全球语言支持」，点击确定后重启电脑生效。如果后续发现老旧的GBK编码软件出现乱码，可按相同路径取消勾选恢复。
3. 彻底清理残留后重装Compass
   先卸载已安装的所有版本MongoDB Compass，打开资源管理器，在地址栏分别输入以下路径并删除对应文件夹的全部内容：
   • %APPDATA%\MongoDB Compass
   • %LOCALAPPDATA%\Programs\mongodb-compass
     清理完成后再安装对应版本的Compass即可。

内容的提问来源于stack exchange，提问作者jenigen