如何修复Mac上conda基础环境中损坏的sqlite3？

问题背景 #

通过mamba update python=3.9将conda基础环境的Python从3.8升级到3.9后，导入sqlite3时出现以下错误：

Python 3.9.15 | packaged by conda-forge | (main, Nov 22 2022, 08:55:37) 
[Clang 14.0.6 ] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sqlite3
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Users/rosborn/opt/miniconda3/lib/python3.9/sqlite3/__init__.py", line 57, in <module>
    from sqlite3.dbapi2 import *
  File "/Users/rosborn/opt/miniconda3/lib/python3.9/sqlite3/dbapi2.py", line 27, in <module>
    from _sqlite3 import *
ImportError: dlopen(/Users/rosborn/opt/miniconda3/lib/python3.9/lib-dynload/_sqlite3.cpython-39-darwin.so, 0x0002): Symbol not found: (_sqlite3_enable_load_extension)
  Referenced from: '/Users/rosborn/opt/miniconda3/lib/python3.9/lib-dynload/_sqlite3.cpython-39-darwin.so'
  Expected in: '/usr/lib/libsqlite3.dylib'

尝试复制其他正常Python3.9环境的sqlite相关文件无效，且无管理员权限修改系统库。

疑问解答 #

Conda是否会链接系统libsqlite？ #

Conda-forge提供的Python包默认优先使用环境内的独立sqlite库，但基础环境在升级过程中可能因依赖冲突、旧文件残留，导致Python的_sqlite3扩展错误链接到系统sqlite库。

为什么独立的py39环境不受影响？ #

独立创建的py39环境是全新初始化的，所有依赖（包括sqlite）均为conda-forge提供的完整独立版本，不存在旧环境的残留配置，因此不会依赖系统库。

修复方案（无需管理员权限） #

1. 强制重新安装sqlite与Python包 #

通过强制覆盖现有文件，修复可能的损坏或链接错误：

mamba install -n base --force-reinstall sqlite python=3.9

2. 确保conda环境库路径优先级 #

激活base环境后，检查动态库加载路径是否包含conda库目录：

echo $DYLD_LIBRARY_PATH

正常应显示/Users/rosborn/opt/miniconda3/lib在最前端。若未包含，手动添加并永久生效：

# 临时生效
export DYLD_LIBRARY_PATH="/Users/rosborn/opt/miniconda3/lib:$DYLD_LIBRARY_PATH"

# 永久生效（根据shell类型选择配置文件）
echo 'export DYLD_LIBRARY_PATH="/Users/rosborn/opt/miniconda3/lib:$DYLD_LIBRARY_PATH"' >> ~/.zshrc
# 或
echo 'export DYLD_LIBRARY_PATH="/Users/rosborn/opt/miniconda3/lib:$DYLD_LIBRARY_PATH"' >> ~/.bash_profile

3. 验证依赖链接是否正确 #

激活base环境后，检查sqlite库来源：

import sqlite3
print(sqlite3.sqlite_version)
print(sqlite3.__file__)

同时用otool查看_sqlite3.so的依赖：

otool -L /Users/rosborn/opt/miniconda3/lib/python3.9/lib-dynload/_sqlite3.cpython-39-darwin.so

正常应显示依赖@rpath/libsqlite3.dylib（指向conda环境内的库），而非系统的/usr/lib/libsqlite3.dylib。若仍指向系统路径，清理conda缓存后重新安装：

mamba clean -a
mamba install -n base --force-reinstall sqlite python=3.9

4. 临时替代方案 #

若以上步骤无效，从正常py39环境复制sqlite库到base环境：

cp /Users/rosborn/opt/miniconda3/envs/py39/lib/libsqlite3.dylib /Users/rosborn/opt/miniconda3/lib/

复制完成后重新测试sqlite3导入。

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