Python 3.6.3环境下FastAPI项目使用SQLAlchemy连接SQLite测试时无法导入_sqlite3模块的问题

你遇到的核心问题是你的Python 3.6.3编译时未包含SQLite的C扩展支持，或是系统缺少SQLite开发依赖，导致内置sqlite3模块无法正常加载。另外直接安装pysqlite3没用，是因为SQLAlchemy默认会优先调用Python内置的sqlite3，而非你安装的第三方库。下面给你几个可行的解决思路：

1. 重新编译Python 3.6.3，确保包含SQLite支持 #

你用pyenv管理Python版本，大概率是当初安装3.6.3时，系统没装SQLite的开发包，导致Python编译时跳过了sqlite3模块的构建。按以下步骤操作：

步骤1：安装系统级SQLite开发依赖 #

• Debian/Ubuntu系：

  sudo apt-get update && sudo apt-get install libsqlite3-dev
  

• CentOS/RHEL系：

  sudo yum install sqlite-devel
  

步骤2：重新安装Python 3.6.3 #

先卸载现有版本，再重新安装（pyenv会自动完成重新编译）：

pyenv uninstall 3.6.3
pyenv install 3.6.3

安装完成后，验证sqlite3是否可用：

import sqlite3
print(sqlite3.version)

如果能正常打印版本号，说明问题已解决。

2. 强制SQLAlchemy使用第三方pysqlite3库 #

如果不想重新编译Python，可以让SQLAlchemy直接调用你安装的pysqlite3作为DBAPI，而非内置的sqlite3。注意要安装预编译的pysqlite3-binary包（避免编译失败，适配Python 3.6）：

步骤1：安装pysqlite3-binary #

pipenv install --dev pysqlite3-binary

步骤2：修改SQLAlchemy引擎配置 #

在测试环境的数据库配置中，显式指定dbapi参数为pysqlite3：

import pysqlite3
from sqlalchemy import create_engine, sessionmaker, declarative_base

# 内存SQLite或文件SQLite都适用，这里以内存示例
engine = create_engine(
    "sqlite:///",
    connect_args={"check_same_thread": False},  # SQLite多线程环境需要添加该参数
    dbapi=pysqlite3
)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
Base = declarative_base()

这样SQLAlchemy就会调用你安装的pysqlite3，不再尝试加载内置的_sqlite3模块。

3. 测试环境的额外注意事项 #

• 每次测试前，记得用Base.metadata.create_all(bind=engine)创建测试表，测试结束后用Base.metadata.drop_all(bind=engine)清理数据，避免测试间的污染。
• 可以用pytest fixture统一管理数据库会话，示例如下：

  import pytest
  from sqlalchemy.orm import Session
  
  @pytest.fixture(scope="function")
  def db_session():
      engine = create_engine("sqlite:///", dbapi=pysqlite3, connect_args={"check_same_thread": False})
      Base.metadata.create_all(bind=engine)
      session = Session(bind=engine)
      yield session
      session.rollback()
      session.close()
      Base.metadata.drop_all(bind=engine)
  

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