database-driver-design

本技能为开发高性能 Swift 数据库客户端库的工程师提供专业架构指导。重点在于网络传输、类型安全 API 设计与并发处理的整合，并运用 valkey-swift 和 postgres-nio 等库中成熟的模式。目标是协助开发者超越简单的封装，进而构建稳定、低延迟且内存安全的生产级服务端实现。

• 实现自定义网络协议解析器与序列化器以降低延迟。

• 使用明确的状态机管理连接生命周期，防止死锁与竞争条件。

• 设计非阻塞 IO (NIO) 通道处理器，实现高效的数据库通信。

• 使用 unownedExecutor 优化 Actor 与 Event Loop 的对齐，消除不必要的线程切换。

• 构建支持背压控制 (Backpressure) 的流式系统，防止大数据集造成的内存耗尽。

• 通过编译期类型检查与 ExpressibleByStringInterpolation 来强制执行参数化查询，防止 SQL 注入。

• 设计「命令作为类型」(Command-as-Type) 的架构，提升 API 人机工程学与返回类型安全性。

• 目标对象：后端工程师、基础设施库维护者以及 Swift 服务端开发者。

• 典型应用场景：创建新的数据库驱动程序 (NoSQL 或 SQL)、开发 ORM 底层协议，或优化现有的 NIO 数据库集成。

• 输入需求：数据库规格文档、协议定义 (如长度前缀二进制格式) 与吞吐量/延迟性能目标。

• 务实限制：务必优先采用类型安全模式而非基于字符串的动态代码。确保与 Swift 6 结构化并发保持一致，并确保所有状态管理皆具备 Sendable 属性。处理 NIO 缓冲区时，应优先考虑零拷贝 (Zero-copy) 作业与明确的内存生命周期管理。