如何构建与共享数据库的外部Python包联动的Django项目结构

结合你当前的Django项目结构，这个自主开发的SQLAlchemy数据处理包不要和Django原生业务代码混放，推荐在项目根目录（和manage.py同级）新增独立目录存放，调整后的项目结构参考：

django_project
│-- django_project
    │--__init__.py
    │-- asgi.py
    │-- settings.py
    │-- urls.py
    │-- wsgi.py
│-- app
    │-- migrations
    │-- __init__.py
    │-- admin.py
    │-- apps.py
    │-- models.py
    │-- tests.py
    │-- views.py
│-- external_packages  # 新增：存放自主开发的外部依赖包
    │-- __init__.py
    │-- sa_models.py  # 原包的SQLAlchemy映射定义
    │-- data_processor.py  # 原包的核心数据处理逻辑
│-- manage.py
│-- media
│-- static
│-- templates

注意：不要把这个外部包直接放进现有Django app的目录下，否则Django的应用扫描机制会误把SQLAlchemy的模型类识别成Django ORM模型，触发无意义的迁移报错。

• 先明确两套ORM的权责边界：Django ORM全权负责面向接口的业务逻辑，包括用户数据CRUD、权限校验、序列化返回、后台管理这些面向终端用户的流程；SQLAlchemy包全权负责非业务侧的离线处理、批量计算、大数据量清洗这类高吞吐任务，两边尽量操作不同的数据库表，从根源上减少模型交叉的可能。
• 如果业务逻辑要求两套ORM必须操作同一张表，统一将表结构的定义主权划给Django ORM：SQLAlchemy侧不要手写全量的表映射字段，直接用内置的automap模块反射Django已经通过迁移建好的表结构，完全避免两边字段定义重复、类型不一致的问题。反射的示例代码：

from sqlalchemy.ext.automap import automap_base
from your_project.external_packages.db_connect import get_sa_engine

engine = get_sa_engine()
Base = automap_base()
# 直接扫描数据库已存在的表结构生成映射，不需要手写类定义
Base.prepare(engine, reflect=True)
# 直接引用反射后的表映射即可
BusinessTable = Base.classes.app_businessmodel

• 数据库连接配置统一收口：不要把SQLAlchemy的连接参数硬编码在外部包里，在Django的settings.py中统一从环境变量读取数据库配置，初始化SQLAlchemy引擎时直接复用Django已经加载的配置项，统一连接池参数，避免出现两边连接的库地址不一致的低级问题。连接初始化的示例代码：

# 放在项目根目录的db_connect.py中
from sqlalchemy import create_engine
from django.conf import settings

def get_sa_engine():
    db_conf = settings.DATABASES['default']
    db_url = f"mysql+pymysql://{db_conf['USER']}:{db_conf['PASSWORD']}@{db_conf['HOST']}:{db_conf['PORT']}/{db_conf['NAME']}?charset=utf8mb4"
    return create_engine(db_url, pool_size=5, max_overflow=10)

• 事务逻辑严格解耦：如果接口流程中既要用到Django ORM操作，又要调用SQLAlchemy的处理逻辑，不要把两边的事务绑定在同一个会话里。先等Django侧的业务数据通过自身事务完全提交成功后，再触发外部包的处理逻辑，避免出现两边事务回滚不同步、数据写入不一致的问题。

• 不要为了对齐模型完全把Django ORM替换成SQLAlchemy，否则会导致Django admin、权限系统、序列化层全部失去适配基础，完全得不偿失。
• SQLAlchemy的连接引擎要做延迟初始化，不要在Django应用加载阶段（比如apps.py的ready()方法）直接创建连接池，等实际调用数据处理逻辑时再初始化，避免Django启动时就占满数据库连接数。
• 跨层级传参时不要把Django ORM的模型对象直接传给SQLAlchemy的处理方法，要先转成原生字典、列表格式再传递，避免两个ORM的会话绑定导致的内存泄漏问题。

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