核心功能
该技能提供了一套完整的异步数据库操作规范，基于 tkms 框架的 AsyncSqlSessionTemplate 封装了 MySQL 8.0 的 CRUD 操作。核心 API 涵盖插入（insert）、更新（update）、单条查询（query_one）、列表查询（query_list）四大基础能力，强制要求使用 :param 参数化占位符，从根本上杜绝 SQL 注入风险。
显著优点
1. 异步原生设计：基于 async/await 模式，适合高并发 Web 服务，避免同步数据库 I/O 阻塞事件循环
2. 防注入安全机制：全程禁止字符串拼接 SQL，参数化查询为强制性规范
3. 工程化约束明确：表名前缀（t_）、字符集（UTF8mb4）、主键命名（tid）、时间字段规范等约定统一，降低协作成本
4. 性能优化指导：内置索引设计建议、N+1 查询规避方案、分页 LIMIT/OFFSET 最佳实践
5. 事务原子性支持：框架级事务封装，批量操作可保障数据一致性
潜在局限性
- 框架绑定性强：深度依赖 tkms 生态，迁移至 SQLAlchemy、Tortoise ORM 等方案需重写 DAO 层
- 手写 SQL 门槛：要求开发者具备 MySQL 索引优化、执行计划分析能力，非纯 ORM 的零 SQL 体验
- 分页效率瓶颈：传统 OFFSET 分页在千万级数据量下深度分页性能衰退，未覆盖游标分页（cursor-based）方案
- 缺乏连接池调优指南：未涉及连接池大小、超时策略、断线重连等生产级配置
适合人群
- 使用 tkms 框架构建 Python 异步服务的后端工程师
- 需从 ORM 下沉至原生 SQL 以优化查询性能的团队
- 负责 DAO 层代码审查、SQL 规范制定的技术负责人
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| SQL 注入 | 违规使用字符串拼接绕过参数化 | Code Review 强制检查，静态扫描工具拦截 |
| 索引失效 | 隐式类型转换、函数操作导致全表扫描 | EXPLAIN 验证执行计划，覆盖常见查询场景 |
| 连接泄露 | 未正确释放会话或异常未回滚 | 统一上下文管理器封装，监控连接池饱和度 |
| 深分页慢查询 | OFFSET 过大导致服务器排序压力 | 业务层限制最大页码，或改用游标分页 |