SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

这是一套用于构建生产级 Axum + Diesel + utoipa API 的 Rust 开发技能,遵循 API Design 技能的约定(HTTP 语义、错误格式、状态码、分页契约、安全模式与 DX 原则)。主要能力与用法如下。

代码安全与命名:在 crate 根设置 #![forbid(unsafe_code)]、#![deny(clippy::all)]、#![warn(clippy::pedantic, clippy::nursery)]。命名遵循 Rust API Guidelines,含大小写、缩写、转换方法(as_/to_/into_)、getter 命名与 iterator 方法约定。

Handler 设计:每个公开 handler 为 async 函数,返回 Result<T, ApiError>,必须带 #[utoipa::path] 与 #[tracing::instrument]。可用 FromRequestParts 构建自定义提取器,并覆盖默认 rejection 以返回一致 JSON 错误体。

错误处理:用 thiserror 定义错误枚举,区分 #[from] 与 map_err,保留错误链,实现 RFC 9457 Problem Details,数据库异常日志内部记录、对外返回通用文本,handler 内禁止 unwrap/expect。

输入校验:优先用 garde + axum-valid 做提取器级校验,复杂跨字段规则手动校验,并强制分页边界(clamp/max)。

Diesel 与类型安全:遵循模型优先,读、写、输入三类模型分离;自定义枚举用 diesel_derive_enum;精度敏感数值用 BigDecimal。用 newtype(可借助 nutype)使非法状态不可表示,并实现 From/TryFrom 做层间转换。

事务与批量:两次及以上写操作必须用事务,保持事务短小;用 eq_any 批量查询避免 N+1,聚合在数据库层完成。迁移以 Diesel migration 为唯一 schema 来源,需编写 up.sql 与 down.sql。

限制与补充说明:文中未提供该技能的安装命令、收费方式、平台支持、效果评测或版本信息,这些事实暂未提供。