CodeBuddy数据库API自动生成：完整CRUD路由与验证实战指南
手头有现成的数据库Schema，但后端API开发还没启动？这是许多开发团队都会遇到的典型场景。与其从零开始手动编写每一行代码，不如利用自动化工具快速生成生产就绪的后端服务。CodeBuddy能够智能解析你的数据库Schema，自动推断表结构、字段类型与约束关系，并生成一套包含完整CRUD操作、输入验证和错误处理机制的后端代码，让你能立即聚焦于核心业务逻辑。
根据你的Schema形态和开发偏好，可以选择以下四种高效的生成路径。
一、使用 CodeBuddy CLI + MCP 服务器解析 SQL Schema 文件
对于偏好命令行且拥有标准SQL定义文件的场景，这是最直接的方案。其核心在于通过本地MCP服务器深度解析SQL文件，精准识别主键、外键、非空约束与唯一性约束，并据此生成结构严谨的Express路由代码。生成的代码将自动集成Joi或Yup验证规则，并配置标准的HTTP状态码响应。
操作流程高度标准化：首先，在本地启动MCP服务器，通常执行npm run mcp-server即可。随后，将数据库结构文件命名为database-schema.sql并置于项目根目录。最后，在终端运行：codebuddy generate api --schema database-schema.sql --framework express。
生成完成后，请检查src/routes/目录。你会看到已按表名生成对应的路由文件，每个文件均包含标准的GET、POST、PUT、DELETE路由及其配套中间件，开箱即用。
二、通过自然语言指令触发 CodeBuddy IDE 内置生成器
若你正在使用CodeBuddy的AI IDE进行开发，且项目中的Schema文件已被IDE索引，那么通过自然语言指令生成代码将极为高效。IDE会结合工作区内的.sql或.json模式文件作为上下文，理解你的指令，动态生成符合RESTful规范与OpenAPI 3.0描述的TypeScript代码。
使用方法：在IDE编辑器中，右键点击你的schema文件（例如schema/users.sql），选择“Generate API from Schema”。在弹出的指令框中，用自然语言描述需求，例如：“生成支持 JWT 鉴权的用户表 CRUD 接口，密码字段禁止返回，创建时需校验邮箱格式，更新时跳过密码字段”。
接着，确认目标技术栈（如选择TypeScript + NestJS），并勾选“Include validation pipes and exception filters”选项。生成后，重点查看src/modules/user/user.controller.ts文件，其中应已集成@UseGuards(JwtAuthGuard)等鉴权装饰器及完整的DTO定义。
三、对接 MySQL 数据库直连模式生成实时 API
当你的Schema并非静态文件，而是一个正在运行的MySQL数据库时，CodeBuddy的直连模式是理想选择。该模式直接连接你的MySQL实例，通过查询INFORMATION_SCHEMA获取实时元数据，确保生成的API与线上数据库结构完全同步，非常适合为现有生产数据库快速构建接口。
操作前，需在项目根目录创建mcp-config.json配置文件，填入数据库连接信息。关键一步是必须显式声明"connectionType": "mysql-direct"。
配置完成后，执行命令：codebuddy generate api --live-db --output-dir src/api-generated。当终端出现“✅ Fetched 7 tables, generating controllers…”提示时，表示生成成功。进入src/api-generated目录，你将看到清晰的controller、service、dto子目录结构。注意生成器是否为datetime字段自动添加了@Transform(({ value }) => new Date(value))这类转换逻辑，这体现了工具的细节处理能力。
四、使用 CodeBuddy Web 控制台上传 JSON Schema 进行可视化配置生成
对于不熟悉命令行或偏好可视化配置的开发者，Web控制台提供了直观的解决方案。你可以在界面中上传Schema文件，通过图形化选项配置字段映射、细粒度权限控制、响应字段筛选等，最终导出一个可直接集成到现有项目中的Node.js模块包。
首先，访问https://codebuddy.tencent.com/console/api-generator并登录。点击“Upload Schema”按钮，上传符合JSON Schema Draft-07格式的schema.json文件。
上传后，在“Advanced Options”中，可按需启用功能，例如“Auto-generate Swagger UI endpoint”（自动生成Swagger UI文档端点）和“Add rate limiting middleware per route”（为每个路由添加限流中间件）。配置完成后，点击“Generate & Download”。解压下载的ZIP包，将api-core/目录合并至项目的src/lib/路径下，最后在主文件（如main.ts）中调用setupApiCore(app)函数即可完成集成。