如何解密微信数据库:用 WeKit 日志提取 SQLCipher 密钥完整教程
如何解密微信数据库:用 WeKit 日志提取 SQLCipher 密钥完整教程
微信数据库解密一直是开发者和数据恢复爱好者绕不开的难题:微信主数据库 EnMicroMsg.db 使用 SQLCipher 加密,没有正确的密钥(database key)根本无法打开。这篇教程将手把手教你如何用 WeKit(微信增强模块)的「详细日志」功能,从运行日志中一键提取 SQLCipher 密钥,并把它用于完整解密微信数据库。全程无需逆向、无需反编译,零基础也能照做。
准备工作:安装 WeKit 并确认环境
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 命令行工具即可完成解密。
第一步:开启「详细日志」输出数据库密钥
- 启动微信,进入 WeKit 模块设置(通过 Xposed 框架的模块开关,或 Zygisk 模块的 WebUI 进入)。
- 切换到「设置」Tab,找到「调试」分组,打开 「详细日志」 开关。
- 完全结束微信进程(从最近任务列表中划掉),重新启动微信。
- 随便打开几个聊天窗口,确保微信实际加载了
EnMicroMsg.db等数据库。
模块设置中各 Tab 的说明参见 docs/module-settings.md。
⚠️ 官方提醒:详细日志属于高频日志,可能暴露你的隐私信息(例如数据库密钥本身)。用完记得关闭,见 docs/module-settings.md 中「调试」一节的说明。
第二步:在模块日志中定位 SQLCipher 密钥
- 再次进入 WeKit 模块设置,切换到 「日志」Tab → 选择「运行日志」。
- 在日志正文中搜索关键字
openDatabase或password=(日志内容支持选择文本,可直接复制)。 - 找到类似下面这样的行:
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,备份手机前可先导出。
延伸阅读
- 官方 FAQ 解密章节:docs/faq.md(第 8 节「如何解密微信数据库」)
- 数据库 Hook 源码:WeDatabaseApi.kt(
onEnable中挂载openDatabaseHook) - 模块设置与日志 Tab 说明:docs/module-settings.md
- 调试功能一览:docs/SUMMARY.md(「调试」章节,含日志重定向、崩溃拦截等)
- 快速上手:docs/getting-started.md
按照以上 4 个步骤——开日志 → 找密钥 → 跑 sqlcipher → 图形化查看,你就能在 10 分钟内把加密的微信数据库变成随手可查的 SQLite 文件。祝折腾愉快!