flask无内置依赖注入，需用dependency_injector等库实现；聚合根须纯净、封装不变性规则；领域逻辑与基础设施严格分层；sqlalchemy模型不可直接作聚合根。
Flask里没有内置的依赖注入容器，得自己搭
Flask 本身是轻量级框架，不提供 Service、Repository 或 UnitOfWork 的自动注册与解析机制。你不能像 Spring 或 NestJS 那样写个 @Injectable() 就完事。常见错误是直接在路由函数里 import 一堆服务类再手动实例化，结果导致测试难、耦合高、聚合边界模糊。
实操建议：
- 用
flask.g或自定义应用上下文管理器暂存请求生命周期内的服务实例（适合简单项目） - 更推荐用
dependency_injector库 —— 它轻量、无侵入、支持单例/工厂/范围作用域，且能和 Flask 的app.app_context()对齐 - 避免把
db.session或redis.Redis()直接塞进__init__.py全局变量，它们应作为依赖被注入到Repository构造函数中 - 聚合根（如
Order）不应持有数据库连接或 HTTP 客户端，它的方法只做领域逻辑判断；持久化交给OrderRepository
按聚合根组织目录结构，但别让文件夹变成“功能分类垃圾桶”
很多人一上来就建 /domain/order/、/domain/product/，然后把 models.py、services.py、dtos.py 全塞进去 —— 这不是 DDD，是披着领域外衣的 MVC 拆分。关键在于：每个聚合根是否真正封装了不变性规则？它的状态变更是否只能通过聚合根暴露的方法触发？
实操建议：
-
/domain/order/下只放order.py（聚合根类）、order_item.py（实体）、order_exceptions.py（领域异常），其他一律不放 -
/infrastructure/persistence/sqlalchemy/order_repository.py实现OrderRepository接口，它引用domain.order，但domain.order绝不能 import 任何 infra 层代码 - 跨聚合的协作（比如下单后扣减库存）用领域事件（
OrderPlaced）+ 异步处理，而不是在Order里调InventoryService - 接口定义（如
OrderRepository协议类）放在/domain/ports/，而非 infra 层，否则违反依赖倒置
Flask 路由层必须严格隔离领域逻辑，别在视图里做业务判断
典型错误是写一个 create_order() 视图，里面 parse JSON → 校验字段 → 创建 Order 实例 → 调 db.session.add() → commit → 返回响应。这等于把应用层、领域层、基础设施层全揉在一起，Order 类根本没机会表达“库存不足时不能创建”这类规则。
实操建议：
- 视图函数只做三件事：解析输入（用
pydantic.BaseModel）、调用应用服务（如order_service.place_order(...)）、格式化输出 - 应用服务（
OrderService）是薄薄一层，负责协调聚合根、仓储、领域事件发布，但它不包含业务规则 —— 规则在Order自身的confirm()或cancel()方法里 - 所有领域异常（如
InsufficientStockError）必须从领域层抛出，并在 Flask 的@app.errorhandler中统一转成 400/409 响应，不要用try/except在视图里吞掉 - 别为了“看起来像 DDD”而在路由里加
from domain.order import Order然后直接 new 实例 —— 那只是换了个地方写脚本
SQLAlchemy 模型不能直接当聚合根，得做映射层
很多人把 OrderModel（继承 Base）当成聚合根，用 session.query(OrderModel).filter(...) 查出来就直接当领域对象用。问题在于：SQLAlchemy 模型自带 ORM 行为（延迟加载、关系代理、_sa_instance_state），会污染领域模型的纯净性，也导致单元测试时绕不开数据库。
实操建议：
- 聚合根（
Order）是纯 Python 类，不含任何 SQLAlchemy 注解或父类，构造函数参数全是原始类型或值对象 - 仓储实现里，用
OrderModel查询数据，再手动 map 到Order实例（可用dataclasses.asdict()或pydantic.parse_obj_as()辅助） - 保存时反向操作：先调
order.to_dict()或类似方法提取数据，再用OrderModel(**data)创建 ORM 实体，最后session.add() - 如果聚合内含集合（如订单项），不要用
relationship自动加载，而是在OrderRepository.get_by_id()中显式 join 查询并组装，确保每次获取聚合都是完整、一致的状态
最常被忽略的一点：聚合根的构造函数不该接受 id: UUID 和 status: str 这种原始参数，而应接收 order_id: OrderId、status: OrderStatus 这样的值对象 —— 否则校验逻辑就散落在各处，DDD 的边界也就形同虚设。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
