Flask-SQLAlchemy多模型配置中仅Package模型出现__table__属性错误

核心问题定位 #

报错AttributeError: module 'models.Package' has no attribute '__table__'说明你代码中引用的Package是模块对象，而非定义的Package模型类，导致无法找到SQLAlchemy生成的__table__属性。

排查与修复步骤 #

1. 检查模块导入的命名冲突 #

• 确认models目录下的模型文件名和类名匹配：你的Package类定义在models/Package.py中，确保文件名大小写和__init__.py中的导入语句一致（Linux/Docker环境大小写敏感）。
• 排查命名冲突：避免模型文件名与Python内置模块或其他自定义模块重名。

2. 验证models/__init__.py的导入正确性 #

确保models/__init__.py中确实从Package.py导入了Package类，而非模块本身：

# models/__init__.py
from .Package import Package  # 确认这行正确，且Package.py中存在Package类

3. 检查Package模型的db实例一致性 #

确认Package模型中导入的db和其他正常工作的模型使用的是同一个SQLAlchemy实例：

# Package.py中的导入要和其他模型一致
from app import db  # 确保app.py中的db是全局唯一的SQLAlchemy实例

4. 清理Docker环境缓存 #

Docker容器内可能存在旧的Python字节码缓存，导致导入错误：

• 删除models目录下的__pycache__文件夹
• 重新构建Docker镜像时，确保.dockerignore未排除必要文件，且构建过程未缓存旧文件

5. 替换手动建表方式（更可靠方案） #

放弃逐个调用__table__.create()的方式，改用SQLAlchemy内置的create_all()方法，它会自动检测所有继承db.Model的模型并创建表：

if __name__ == "__main__":
    logger.warning('SqlAlchemy: Creating tables')
    with app.app_context():
        db.create_all(checkfirst=True)  # 替代所有手动建表语句
        # 启动应用

6. 验证模型类型 #

在创建表前，打印Package的类型，确认它是模型类而非模块：

with app.app_context():
    print(type(Package))  # 正常输出应为<class 'models.Package.Package'>，而非<class 'module'>

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