必须替换sqlite3.dll,Navicat 16自带DLL不支持SQLCipher,检测到加密头即拒绝加载;需用e_sqlcipher.dll替换并重启,连接时“密码”填明文,Java端须用sqlite-jdbc-crypt驱动且key为十六进制字符串。

Navicat 16 连接加密 SQLite 必须替换 sqlite3.dll
不换 DLL,填再多次密码也连不上——Navicat 16 自带的 sqlite3.dll(Windows)或 libsqlite3.dylib(macOS)完全不支持 SQLCipher。它检测到数据库头是加密格式后,直接拒绝加载,报错“file is encrypted or is not a database”或静默失败。
必须手动替换:
- 从 NuGet 安装
SQLitePCLRaw.bundle_e_sqlcipher,提取对应平台的e_sqlcipher.dll(如win-x64/e_sqlcipher.dll) - 进入 Navicat 安装目录(例如
C:\Program Files\PremiumSoft\Navicat Premium 16),备份原sqlite3.dll - 把
e_sqlcipher.dll复制进去,并重命名为sqlite3.dll - 重启 Navicat 16,否则新 DLL 不生效
“高级”选项卡里填的是明文密码,不是 hex 密钥
Navicat 的“已加密”流程是:你输明文 → 它内部用 PBKDF2-HMAC-SHA1(64000 次迭代)派生出 32 字节密钥 → 解密 AES-256 数据库。所以你在“密码”框里必须填原始设置时输入的明文(比如当时填了 MyPass!2026,这里就填这个,**不能填 4d79506173732132303236**)。
常见错误:
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
- 填了 hex 字符串,连接测试通过但打开表时报
database disk image is malformed - 大小写/空格/中文符号不一致(比如复制粘贴时多了一个不可见空格)
- 误以为“密码”是登录凭证,试图用其他账号密码乱试
JDBC 连接同一数据库时 key 参数必须是十六进制字符串
Java 程序不能复用 Navicat 里的明文密码字段值。标准 org.xerial:sqlite-jdbc 驱动压根不认识 SQLCipher,必须换用 io.github.willena:sqlite-jdbc-crypt,且 URL 中的 key 必须是 hex 格式:
- Maven 依赖:
<groupid>io.github.willena</groupid><artifactid>sqlite-jdbc-crypt</artifactid><version>3.39.2</version> - URL 写法:
jdbc:sqlite:/path/to/db.db?dbmode=navicat_sqlcipher&key=4d79506173732132303236(注意是dbmode=navicat_sqlcipher,不是cipher=sqlcipher) - 驱动类名是:
io.github.willena.sqlite.DBConnection,不是org.sqlite.JDBC
验证 hex 是否正确:用命令行 sqlite3 your.db,执行 PRAGMA key = '4d79506173732132303236'; SELECT count(*) FROM sqlite_master;,能返回数字说明密钥对。
路径和文件状态比密码更容易导致连接失败
即使加密配置全对,Navicat 16 仍可能报 unable to open database file。这不是密码问题,而是底层文件访问失败:
- 必须用绝对路径选中 .db 文件(
C:\data\app.db或/Users/me/app.db),不支持相对路径(如./app.db) - 文件被锁住:Android Studio、VS Code、或你的 App 进程还在持有该数据库句柄,需先关闭
- 权限不足:Linux/macOS 下确保 Navicat 进程有读取权限(
chmod 644 app.db) - 中文路径或空格路径在 Windows 下极易出问题,建议挪到
C:\db\这类干净路径下再试
真正麻烦的从来不是“怎么填密码”,而是确认 Navicat 加载的是哪个 DLL、文件是否真可读、以及 Java 端密钥格式是否和 Navicat 内部派生逻辑对齐——这三处任一错位,都会表现为“密码错误”。

















