用途:指导在 Cloudflare Workers 上使用 chanfana 编写 OpenAPI 端点,适用于需要请求/响应模式定义、校验和 CRUD 接口的接口开发场景。
主要能力:可用 Hono 或 itty-router 快速搭建路由;以 Zod v4 定义 body、query、params、headers 的请求模式与响应模式;通过 getValidatedData() 获取类型安全的校验数据,用 getUnvalidatedData() 判断部分更新时实际传入的字段;提供 Create、Read、Update、Delete、List 等 CRUD 自动端点基类,支持 before/after 钩子和过滤、搜索、排序配置;提供 D1 系列端点类直接对接 Cloudflare D1 数据库,内置 SQL 标识符校验与约束冲突消息处理。
使用方式:定义继承 OpenAPIRoute 的端点类并设置 schema;自动端点需在 _meta 中提供 model.schema、primaryKeys,D1 端点还需 tableName 并将 dbName 设为 wrangler.toml 的绑定名;用 fromHono 或 fromIttyRouter 注册路由。嵌套路由可用 pathParameters 与复合主键。
限制:chanfana v3 使用 Zod v4 语法,旧版 z.string().email() 等写法已废弃;可选字段带 .default() 时在校验数据中总有值,部分更新需改用 getUnvalidatedData()。资料未说明具体定价、部署步骤或性能数据。