Windows环境下Python加载SQLite3的SpatiaLite扩展失败问题

问题重现 #

在Windows系统中用Python搭建基于SQLite的应用，加载mod_spatialite 5.0.1扩展时，无论调整何种路径方式，均报错：

OperationalError: The specified module could not be found.

环境信息：

• Python 3.10（或纯净虚拟环境Python3.8.10）
• sqlite3 2.6
• mod_spatialite 5.0.1
• 带预装依赖的Python环境（Spyder附带3.8.10、ArcGIS附带3.9.11）可正常运行，纯净虚拟环境不行。

核心原因 #

这个错误绝大多数情况不是找不到mod_spatialite.dll本身，而是它依赖的其他DLL缺失或版本不兼容。那些能正常运行的Python环境已经预装了proj、geos、匹配版本的sqlite3等依赖库，纯净虚拟环境没有这些组件。

具体解决步骤 #

1. 补齐所有依赖DLL #

• 下载完整的mod_spatialite二进制包，不要单独提取mod_spatialite.dll，要包含它所有依赖文件（比如proj.dll、geos.dll、geos_c.dll、sqlite3.dll等）。
• 用Windows自带的dumpbin工具检查依赖：打开VS命令提示符，运行dumpbin /dependents "path\to\mod_spatialite.dll"，输出里的所有DLL都要存在于同一个目录，或者系统PATH能找到的地方。

2. 确保sqlite3版本兼容 #

mod_spatialite 5.0.1要求sqlite3版本至少3.30.0以上，而你当前Python自带的sqlite3版本为2.6（此为sqlite自身版本，非Python版本），完全不达标：

• 要么升级Python到3.11+（自带的sqlite3版本更高）；
• 要么手动替换Python安装目录（或虚拟环境的DLL目录）里的sqlite3.dll为匹配版本（必须和Python位数一致：32位/64位，且版本≥3.30）。替换前一定要备份原文件。

3. 正确设置PATH路径 #

不要修改sys.path（这是给Python模块用的），重点调整系统PATH环境变量，把mod_spatialite及依赖DLL的目录放到最前面，确保系统优先加载这里的文件：

import os
import sqlite3

# 替换为你的mod_spatialite文件夹绝对路径
spatialite_dir = r"C:\your\path\to\mod_spatialite_binaries"
# 把目录加到PATH最前面，用os.pathsep适配Windows的分号分隔规则
os.environ['PATH'] = spatialite_dir + os.pathsep + os.environ['PATH']

# 尝试加载扩展
conn = sqlite3.connect(':memory:')
conn.enable_load_extension(True)
try:
    # Windows下无需加.dll后缀，sqlite会自动识别
    conn.load_extension('mod_spatialite')
    print("SpatiaLite加载成功")
except Exception as e:
    print(f"加载失败：{str(e)}")

4. 纯净虚拟环境的额外处理 #

纯净虚拟环境会继承基础Python的sqlite3.dll，如果基础Python的版本不够，即使虚拟环境里放了新的DLL也可能被覆盖。可以：

• 把匹配版本的sqlite3.dll放到虚拟环境的Scripts目录下；
• 或者在代码里先把虚拟环境Scripts目录加到PATH最前面，再加载扩展。

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