SQLite内存数据库在FastAPI+SQLAlchemy中表创建异常问题

核心差异原因 #

SQLite内存数据库（sqlite:///:memory:）和文件型数据库的本质区别在于连接隔离性：

• 文件型数据库：所有连接共享磁盘上的同一个文件，建表操作会持久化到文件，后续任何连接都能读取到已创建的表。
• 内存数据库：默认情况下，每创建一个新的数据库连接，就会生成一个独立的内存数据库实例。之前在某个连接里执行的建表操作，只属于那个实例，新连接访问的是全新的空数据库，自然找不到表。

问题根源 #

你遇到的no such table: thing错误，本质是建表和插入操作使用了不同的内存数据库实例：

• 建表语句可能是在某个初始化连接/会话中执行并提交，但FastAPI的请求处理通常是多线程（或异步）模式，每个请求会创建新的会话/连接，这个新连接对应的是全新的内存数据库，没有之前创建的表结构。
• 尽管SQLAlchemy日志显示建表成功，但那只是在某个临时连接里完成的，和后续插入数据的连接不是同一个实例。

解决办法 #

要让内存数据库被多个连接共享，有两种可行方案：

1. 使用共享缓存的URI格式
   把内存数据库的连接字符串改成：

   engine2 = create_engine("sqlite:///file:memdb?mode=memory&cache=shared&uri=true")
   

   这种方式会让同一个进程内的所有连接共享同一个内存数据库实例，建表后所有请求的连接都能访问到表。

2. 复用同一个连接/会话
   确保建表和所有数据操作都使用同一个数据库连接，避免创建多个独立的引擎实例。比如在FastAPI中，把会话依赖配置为复用同一个引擎的连接池，而不是每次请求新建引擎。

内容的提问来源于stack exchange，提问作者Abraham Murciano Benzadon