xfy
4f6a7be44c
- 更新各目录 AGENTS.md 的子目录信息 - 添加新增目录的 AGENTS.md 文件 - 更新 docs/prompts.md 添加新的提示词 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.0 KiB
1.0 KiB
utils
Purpose
HTTP 错误处理工具包，提供统一的错误响应助手函数，减少代码库中散落的 ctx.Error 调用模式。
Key Files
| File | Description |
|---|---|
httperror.go |
HTTP 错误类型定义和发送助手函数 |
For AI Agents
Working In This Directory
- 使用预定义的
HTTPError变量（如ErrNotFound,ErrForbidden）而不是手动构造 - 通过
SendError(ctx, err)发送标准错误响应 - 需要额外详情时使用
SendErrorWithDetail(ctx, err, detail)
Testing Requirements
- 无独立测试文件，错误处理在其他模块测试中覆盖
Common Patterns
// 发送标准错误
utils.SendError(ctx, utils.ErrNotFound)
// 发送带详情的错误
utils.SendErrorWithDetail(ctx, utils.ErrBadGateway, "backend timeout")
Dependencies
External
github.com/valyala/fasthttp- HTTP 状态码定义