用途:在实现持久化、ORM、Repository 模式、防 N+1 查询与事务管理时使用,覆盖 JPA/Hibernate、TypeORM、Prisma、Django ORM、SQLAlchemy、GORM、ActiveRecord、EF Core。
主要能力:以 Repository 隐藏 ORM 细节并向 Service 返回领域对象;默认防 N+1,使用 join fetch、include、select_related、prefetch_related、joinedload、selectinload、Preload 等;支持声明式与编程式事务、隔离级别与传播行为;支持批量插入与批量更新、批量大小配置;支持复杂查询与参数化原生 SQL;支持读写分离与多数据源,读事务可标记 readOnly 路由从库;GraphQL 场景可用 DataLoader 批量合并查询。
必要用法:Repository 接口按业务设计,事务边界等于业务操作边界,不在事务中做 HTTP、邮件等外部调用;批量操作使用 bulk_create、createMany、saveAll 等;自定义 SQL 必须参数化;大查询加 limit;测试使用真实数据库或 Testcontainers;示例中保留 、@Transactional、select_related、prefetch_related、Prisma $transaction 等原样写法。
限制:资料未提供具体安装命令、依赖版本、价格与平台信息;隔离级别、批量性能收益描述为一般性说明,未给出可验证基准;嵌套事务与分布式事务需谨慎评估。