如何解密微信数据库:用 WeKit 日志提取 SQLCipher 密钥完整教程

原创2026-10-15 22:25:471,760 阅读

如何解密微信数据库:用 WeKit 日志提取 SQLCipher 密钥完整教程

微信数据库解密一直是开发者和数据恢复爱好者绕不开的难题:微信主数据库 EnMicroMsg.db 使用 SQLCipher 加密,没有正确的密钥(database key)根本无法打开。这篇教程将手把手教你如何用 WeKit(微信增强模块)的「详细日志」功能,从运行日志中一键提取 SQLCipher 密钥,并把它用于完整解密微信数据库。全程无需逆向、无需反编译,零基础也能照做。

准备工作:安装 WeKit 并确认环境

WeKit 微信增强模块图标,用于提取 SQLCipher 密钥解密微信数据库

WeKit 是一个适用于微信的开源增强模块,支持 Xposed 与 Zygisk 两种加载方式。开始之前,请先确认以下条件:

项目 要求
宿主包名 com.tencent.mm 或以其开头的任意包名(含分身微信)
微信版本 国内版 8.0.65 及以上(建议 8.0.69 ~ 8.0.76)
Android 版本 9(SDK 28)及以上
架构 ARM64(arm64-v8a)
加载方式 Xposed API 51~102 或 Zygisk

完整的环境要求与版本支持列表见官方文档 docs/getting-started.md,安装步骤见 docs/installation.md。

💡 提示:如果模块未能加载或功能缺失,优先阅读 docs/faq.md 的「模块不加载」一节排查。

原理:密钥为什么能直接出现在日志里

WeKit 内置的数据库服务 API(WeDatabaseApi.kt)会 Hook 微信内核的 SQLiteDatabase.openDatabase 方法。当你在模块设置中开启「详细日志」时,每次微信打开数据库,它都会把 数据库路径、SQLCipher 密钥(password)、加密参数 原样写入模块日志,形如:

WeDatabaseApi: openDatabase() called with: name=/data/user/0/com.tencent.mm/MicroMsg/xxxxxxxxx/EnMicroMsg.db, password=xxxxxxx, cipherSpec=0,false,0,4000,1024

其中 password=xxxxxxx 后面的字符串就是我们要找的 SQLCipher 密钥。这就是整个教程的核心——把 Hook 到的密钥拿下来,交给 sqlcipher 命令行工具即可完成解密。

第一步:开启「详细日志」输出数据库密钥

  1. 启动微信,进入 WeKit 模块设置(通过 Xposed 框架的模块开关,或 Zygisk 模块的 WebUI 进入)。
  2. 切换到「设置」Tab,找到「调试」分组,打开 「详细日志」 开关。
  3. 完全结束微信进程(从最近任务列表中划掉),重新启动微信。
  4. 随便打开几个聊天窗口,确保微信实际加载了 EnMicroMsg.db 等数据库。

模块设置中各 Tab 的说明参见 docs/module-settings.md。

⚠️ 官方提醒:详细日志属于高频日志,可能暴露你的隐私信息(例如数据库密钥本身)。用完记得关闭,见 docs/module-settings.md 中「调试」一节的说明。

第二步:在模块日志中定位 SQLCipher 密钥

  1. 再次进入 WeKit 模块设置,切换到 「日志」Tab → 选择「运行日志」。
  2. 在日志正文中搜索关键字 openDatabase 或 password=(日志内容支持选择文本,可直接复制)。
  3. 找到类似下面这样的行:
WeDatabaseApi: openDatabase() called with: name=/data/user/0/com.tencent.mm/MicroMsg/3f8a2b.../EnMicroMsg.db, password=aB3xK9..., cipherSpec=0,false,0,4000,1024

需要记录的三样东西:

信息 示例 用途
数据库文件名 EnMicroMsg.db 确定要解密哪个文件
password= 后的字符串 aB3xK9... SQLCipher 密钥
cipherSpec 参数 0,false,0,4000,1024 确认加密参数(见下文说明)

📌 微信目录下有多个数据库(EnMicroMsg.db、MicroMsg.db、MultiProcess.db 等),密钥通常是同一套。本教程以主库 EnMicroMsg.db 为例。

第三步:用 sqlcipher 解密 EnMicroMsg.db

1. 把数据库文件拷出手机

EnMicroMsg.db 位于微信私有目录 /data/user/0/com.tencent.mm/MicroMsg/<哈希目录>/,需要 Root 权限或用支持私有目录的备份方案导出到电脑。

2. 安装 sqlcipher 命令行工具

在你熟悉的包管理器中安装即可,例如:

# Debian / Ubuntu
sudo apt install sqlcipher

# macOS (Homebrew)
brew install sqlcipher

3. 执行解密命令(逐行输入,不要一次性粘贴多行)

官方推荐的完整命令序列(来自 docs/faq.md 第 8 节「如何解密微信数据库」):

sqlcipher ./EnMicroMsg.db

PRAGMA key = '上面复制的密钥';
PRAGMA cipher_compatibility = 1;

ATTACH DATABASE 'decrypted_wechat.db' AS decrypted KEY '';

SELECT sqlcipher_export('decrypted');
DETACH DATABASE decrypted;

.exit

执行 sqlcipher_export 成功后,当前目录会生成 未加密 的 decrypted_wechat.db。

关于 cipherSpec=0,false,0,4000,1024: 对应 hmacAlgorithm,hmacEnabled,kdfAlgorithm,kdfIteration,pageSize。hmacEnabled=false 意味着该库关闭了 HMAC 校验,所以必须配合 PRAGMA cipher_compatibility = 1; 使用——这正是 FAQ 中给出的命令顺序。如果不同库的 cipherSpec 不一致,可按 cipher_page_size、cipher_kdf_iter 等 PRAGMA 做相应调整。

第四步:用 DB Browser for SQLite 查看解密结果

用任意 SQLite 图形工具(如 DB Browser for SQLite)打开 decrypted_wechat.db,你就可以:

  • 浏览 Msg 表查看全部聊天记录(encDecChat 等字段为 base64 编码的消息内容);
  • 查询 contact 表查看好友与群信息;
  • 用 SQL 导出指定会话做数据分析或备份。
-- 示例:查看某个会话的最新消息
SELECT CreateTime, Talker, Type, Content
FROM Msg
ORDER BY CreateTime DESC
LIMIT 100;

常见问题排查

问题 解决办法
日志里搜不到 openDatabase 行 确认「详细日志」开启后重启过微信,且真的打开过聊天窗口;再回「日志」Tab 下拉刷新日志
file is not a database 报错 密钥复制不完整或粘贴错了行;注意日志中 password= 与 cipherSpec 之间的分隔,只取密钥本身
解密后表内容为空 检查是否误用了其他库的密钥;EnMicroMsg.db 与 MicroMsg.db 属于不同进程,密钥需分别提取
模块未激活 按 docs/faq.md 第 1 节排查加载问题;Zygisk 模式需确认 WebUI 中微信开关已打开

安全与隐私注意事项

  • 🔐 密钥即钥匙:拿到 SQLCipher 密钥等于拿到了全部聊天记录,请务必妥善保管密钥和 decrypted_wechat.db,不要上传到网盘或代码仓库。
  • 🧹 用完即关:任务完成后回到模块设置关闭「详细日志」,并可在「日志」Tab 清空已含密钥的运行日志。
  • 📄 合规使用:仅解密自己设备上的数据,遵守当地法律法规与微信服务条款。项目的免责说明见 docs/cosmic-level-disclaimer.md。
  • 🗂️ 数据位置:WeKit 自身的模块数据(含日志)存放在 /sdcard/Android/data/<宿主包名>/WeKit,备份手机前可先导出。

延伸阅读

按照以上 4 个步骤——开日志 → 找密钥 → 跑 sqlcipher → 图形化查看,你就能在 10 分钟内把加密的微信数据库变成随手可查的 SQLite 文件。祝折腾愉快!

登录后查看全文
WeKit