Windows下Python+apsw读取加密SQLite文件报错：no such vfs: zipvfs

问题分析 #

你在Linux下正常运行的APSW操作加密SQLite代码，迁移到Windows后找不到zipvfs VFS，大概率是编译APSW时zipvfs扩展未正确启用，或者zlib依赖配置不到位导致的。

解决方案 #

1. 重新编译APSW并明确启用zipvfs #

之前的--enable-all-extensions可能因为依赖问题跳过了zipvfs，改用更精准的编译命令：

python setup.py fetch --sqlite build --enable-zipvfs install

该命令会单独拉取SQLite源码，只启用zipvfs扩展，减少不必要的依赖冲突。

2. 确保zlib依赖匹配且路径正确 #

• 确认zlibwapi.dll的位数（32/64位）与你的Python版本完全一致，比如Python 3.10 64位必须用64位的zlib库
• 把zlibwapi.dll放到Python的Scripts目录或当前项目根目录，比System32目录的加载优先级更高
• 编译前配置zlib的头文件和库文件路径（替换为你实际的zlib安装路径）：

set LIB=%LIB%;C:\zlib\lib
set INCLUDE=%INCLUDE%;C:\zlib\include

3. 验证APSW是否加载了zipvfs #

安装完成后，在Python终端执行以下代码检查：

import apsw
print(apsw.vfs_names())

如果输出列表中没有zipvfs，说明编译过程存在隐性错误，需要重新查看编译时的控制台输出，排查依赖缺失或编译失败的具体原因。

4. 尝试预编译的APSW包 #

若自行编译始终失败，可选择包含zipvfs的预编译APSW包（需匹配Python版本和Windows位数），安装后再测试代码。

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