SQLAlchemy连接SQLite3如何配置为数据库文件不存在时直接报错

你当前的配置本身是正确的，没有生效的核心原因是 SQLAlchemy的create_engine方法默认采用惰性连接机制：调用create_engine时只会初始化引擎配置，不会立刻和数据库建立真实连接，只有第一次执行SQL操作、或者主动触发连接时才会校验数据库文件状态，所以你期望的create_engine阶段就报错的效果默认不会实现。

修正方案 #

在引擎初始化完成后，主动触发一次连接校验即可实现需求，修正后的代码如下：

#!/usr/bin/env python3
from sqlalchemy import create_engine, Column, Integer
from sqlalchemy.exc import OperationalError
from sqlalchemy.orm import Session, declarative_base

Base = declarative_base()

class SomeTable(Base):
    __tablename__ = 'some_table'
    id = Column(Integer, primary_key=True)

DB_SPECIFIER = 'sqlite+pysqlite:////tmp/non-exist.db?mode=rw'
engine = create_engine(DB_SPECIFIER, echo=False, future=True, connect_args={'uri': True})

# 新增：主动触发连接建立，文件不存在时会直接抛出OperationalError
try:
    with engine.connect():
        pass
except OperationalError as e:
    # 此处可自定义错误处理逻辑
    raise RuntimeError("指定的SQLite数据库文件不存在") from e

session = Session(engine)
x = session.query(SomeTable)

补充说明 #

• 你配置的mode=rw参数是正确的，SQLite在该模式下不会自动创建不存在的数据库文件，会直接返回连接错误。
• 不推荐自行提前判断文件是否存在，该方式存在竞态条件（判断完成后文件被删除的场景下依然会出错），通过SQLite原生参数+主动连接校验的方案可靠性更高。

内容的提问来源于stack exchange，提问作者Craig S. Anderson