小项目实战 2：让 AI 帮你补齐接口设计和异常处理

文章目录

• • 开篇
  • 一、先让 AI 识别接口设计缺口
  • 二、先确定一份接口契约
  • 三、统一异常响应结构
  • 四、让 AI 按契约补齐代码
  • 五、用边界请求验证异常处理
  • 六、我会特别检查的 4 个坑
  • • 1. 错误状态码全部返回 200
    • 2. 错误信息不稳定
    • 3. PATCH 接受整个对象
    • 4. 捕获异常后只返回“请求失败”
  • 七、Day 23 的验收清单
  • 总结

✍创作者：全栈弄潮儿²⁰²⁶

🏡 个人主页：全栈弄潮儿²⁰²⁶

📙 专栏地址：AI 编程进阶实战

开篇

上一篇文章，我们用 AI 搭出了任务清单 API 的第一版骨架。

服务能启动，并不代表接口已经设计完成。真正开始联调后，下面这些问题很快就会出现：

• 创建任务失败时，返回什么结构？
• 任务不存在时，是返回空对象还是 404？
• PATCH 可以修改哪些字段？
• 参数错误和服务器错误，调用方如何区分？

今天就解决这两个问题：

明确接口契约
↓
统一成功响应
↓
统一异常响应
↓
用边界请求验证

一、先让 AI 识别接口设计缺口

不要直接问 A