MongoDB Compass连接报错Invalid UTF-8 string in BSON无法可视化数据咨询

问题根因 #

该报错本质是BSON文档转UTF-8字符串时解析失败，结合你给出的场景信息，已排除MongoDB服务端问题，故障均来自本地运行环境：

• Windows系统非Unicode程序默认编码为GBK/GB2312等非UTF-8格式，Compass加载本地配置、临时文件时触发编码解析错误，是该场景下最高发的故障原因
• 重装MongoDB Compass时默认不会清除用户目录下的历史缓存数据，缓存中损坏的连接记录、异常编码的临时文件会持续触发报错
• Windows登录用户名、Compass安装路径包含中文或特殊非UTF-8字符，Compass读写本地文件时触发编码错误

解决方案 #

按优先级依次执行以下操作，每执行一步验证一次问题是否解决：

1. 修改Windows系统编码设置
   打开「控制面板-区域-管理-非Unicode程序的语言」，点击「更改系统区域设置」，勾选「Beta版：使用Unicode UTF-8提供全球语言支持」，重启电脑后重新打开Compass测试
2. 清除Compass本地缓存

• 完全关闭所有MongoDB Compass进程
• 打开Windows资源管理器，地址栏输入%APPDATA%\MongoDB Compass回车进入缓存目录
• 删除该目录下所有文件，重新打开Compass新建连接测试

3. 修复路径/用户名编码问题
   如果Compass安装路径包含中文，卸载后重新安装到纯英文路径下；如果当前Windows登录用户名包含中文，优先新建纯英文用户名的Windows账号，登录该账号后运行Compass即可。

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