OpenAPI

在 Hono 项目中同时使用 Zod 校验、RPC 类型客户端和 OpenAPI 时，最容易出现路由能运行、客户端能编译、文档却已经漂移。本文用普通 Hono 路由配合 hono-openapi，说明请求 Schema、响应类型、错误契约和接口说明各自应该放在哪里。

API 文档只在开发环境注册，并不代表 Scalar、OpenAPI 生成器和文档路由已经从生产 Bundle 消失。本文以 Bun 构建为例，说明如何用动态导入、编译期常量与产物扫描真正移除文档代码，同时避免把运行时配置和密钥错误地一并内联。