故障排查
常见问题的排查与解决方法
title: 故障排查 description: 常见问题的排查与解决方法 category: troubleshooting order: 1
使用过程中遇到问题?从下方找到对应的问题,点击跳转到解决方案。
1. 多用户时如何选择正确的账号?
在「选择用户」步骤中,如果下拉列表里出现多个 wxid,说明当前设备上曾登录过多个账号:

排查方法
- 任意选择一个用户,点击「确定」
- 系统会自动匹配数据目录(Step 3)
- 打开该目录,查看文件夹内容,确认是否为自己想解密的账号
- 如果不是目标账号,返回 Step 2 选择另一个用户,重复上述步骤
文件夹中通常包含聊天数据库文件,可以根据文件夹大小或修改时间来辅助判断。最近活跃的账号对应的文件夹通常体积更大、修改时间更新。
2. 环境检测失败
如果 Step 1 环境检测未通过:
- 确认 IM 客户端已安装并正在运行
- 确认 IM 客户端已登录账号
- 尝试重启 IM 客户端后再次检测
3. macOS 获取数据密钥失败(task_for_pid failed)
如果在 macOS 上获取密钥时遇到以下报错:
获取数据密钥失败: Error invoking remote method 'localDecrypt:getDataKey':
LocalDecryptCommandError: 0:211: execution error: task_for_pid failed: 5
Make sure: (1) running as root, (2) WeChat is ad-hoc signed (1)
[ERROR] find_all_keys_macos failed with code=1
[HINT] macOS key scan needs permission to read WeChat memory.
这是因为 macOS 的安全机制阻止了应用读取进程内存。有两种解决办法:
方法一:对微信重新签名(推荐)
打开终端,执行以下命令:
sudo codesign --force --deep --sign - /Applications/WeChat.app
输入系统密码后等待完成,然后重启重新解密即可。
方法二:关闭系统 SIP
SIP(System Integrity Protection)是 macOS 的系统完整性保护机制。关闭后可解除进程内存读取限制。
详细操作步骤请参考:macOS 开启或关闭 SIP — 少数派
注意:关闭 SIP 会降低系统安全性,建议优先尝试方法一。操作完成后建议重新开启 SIP。
4. Windows 无法检查更新
Windows 版本目前暂不支持应用内自动更新。这是因为 Windows 软件的数字签名证书正在申请中,尚未完成签名的安装包无法通过系统的自动更新验证。
我们正在积极推进签名申请,敬请期待。
在此期间如需更新到最新版本,请前往 下载页 手动下载最新安装包覆盖安装即可。
如果以上方法仍无法解决问题,请搜索 QQ 群号 740412645 入群留言反馈。