Python中SQLAlchemy Engine全局变量跨模块丢失值问题求助

你的问题核心是导入的database模块并非同一个实例——正常情况下Python模块只会被加载一次，除非因为导入路径错误（比如不同目录下的同名模块、sys.path重复添加导致模块被多次加载），才会出现多次导入创建独立模块实例的情况，导致你在main里初始化的engine在server模块的database实例中不存在。

1. 先排查导入路径问题（最可能的原因） #

先验证两次导入的database是否为同一实例：

• 在main.py中添加：

  import database
  print("Main module database ID:", id(database))
  database.init("sqlite:///your-db.db")
  

• 在server模块中添加：

  import database
  print("Server module database ID:", id(database))
  print("Engine from server:", database.getEngine())
  

如果两次输出的id(database)不一样，说明你导入的是两个不同的database模块：

• 检查项目结构：确保没有多个同名的database.py或database包
• 检查sys.path：避免把项目子目录重复加入sys.path，确保所有模块都从项目根目录进行绝对导入
• 统一导入方式：比如如果项目根目录是project/，所有模块都用import database（前提是database模块在根目录），不要混用相对导入（比如from . import database）和绝对导入

2. 改用单例类管理数据库引擎（更可靠的实现） #

放弃全局变量，用单例类封装引擎，确保无论怎么导入都是同一个实例：
修改database模块代码：

from sqlalchemy import create_engine, Engine
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class _DatabaseEngine:
    _engine: Engine | None = None

    def init(self, url: str = "sqlite:///database.db"):
        if self._engine is None:
            self._engine = create_engine(url)
            Base.metadata.create_all(self._engine)

    def get_engine(self):
        return self._engine

# 创建全局单例实例
db_engine = _DatabaseEngine()

使用方式：

• 在main.py中初始化：

  from database import db_engine
  db_engine.init("sqlite:///custom-url.db")
  

• 在server模块中获取引擎：

  from database import db_engine
  engine = db_engine.get_engine()
  # 后续使用engine操作数据库
  

这种方式完全避免了全局变量的导入问题，因为单例实例是绑定在模块级别的，只要模块被正确加载一次，所有导入都会共享这个实例。

3. 修复原有全局变量方案（如果不想改结构） #

如果坚持用原有全局变量方案，确保所有导入的是同一个模块：

• 确保项目根目录被加入sys.path（可以在main.py开头添加）：

  import sys
  from pathlib import Path
  sys.path.insert(0, str(Path(__file__).parent))
  

• 所有模块统一用import database导入，不要使用from database import engine或其他变体，确保始终通过模块对象访问engine或getEngine()

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