BugHub

从大量 Bug 中，练出风险嗅觉。

12 个 Bug10 类问题持续收录与整理
事务与数据一致性1
读模型与汇总1
  1. 1.合同续约后快照未重建致账单长期按旧单价结算
API、协议与兼容性1
字段与枚举1
  1. 1.上游配置字段格式变更致整包解析失败连带核心数据停更
性能、容量与资源1
查询与数据量1
  1. 1.大数据量场景缓存大Key加串行查询致列表页加载超时
配置、发布与环境1
迁移与回滚1
  1. 1.切换数据源下线旧字段致存量老设备心跳展示为空
可观测性与容灾1
降级与切换1
  1. 1.调用超时被当成空结果吞掉致签约状态卡死不更新
功能逻辑缺陷3
流程与状态错误2
  1. 1.批量审批回调抢锁失败被当成功消费，导致工单未生成
  2. 2.模板必填字段缺失致协议创建失败网点状态卡死无法关闭
规则与策略错误1
  1. 1.两套补货定额优先级设反，导致重复生成补货工单
数据一致性缺陷1
主从与副本不同步1
  1. 1.重签只改主表未重建快照，页面沿用旧到期日
接口与兼容性缺陷1
新老版本兼容1
  1. 1.对象新增字段后，老节点读缓存反序列化报错致服务持续异常
安全与权限缺陷1
越权与权限绕过1
  1. 1.按地理位置派单未按资产归属过滤，跨归属方看到无关数据
前端与交互缺陷1
交互异常1
  1. 1.SDK 未初始化就发请求，导致鉴权头缺失接口返回 401

接入 AI · 让它写代码前先查这个库

通过 MCP 把这套常见 Bug 库接到你的 AI 编码助手。写代码前自查失效模式，写测试用例时对照「测试要点」， 从源头规避同类问题。

① MCP 配置

加入 AI 客户端的 mcp.json，把路径改成 bughub-mcp 的实际位置。

{
  "mcpServers": {
    "bughub": {
      "command": "node",
      "args": ["/绝对路径/bughub-mcp/server.mjs"],
      "env": { "BUGHUB_API_BASE": "https://bughub.vip" }
    }
  }
}
② 提示词

复制给 AI，它就会在写代码 / 测试时主动检索并对照这个库。

你可以使用 BugHub 常见 Bug 库（通过 bughub MCP）来提升代码与测试质量。

请在以下时机主动调用：
- 动手写某个功能前：用 review_context 传入这个功能的描述，召回相关的历史坑，对照规避；
- 写测试用例时：用 search_bugs 按功能 / 领域检索，把每条的「测试要点」补进用例；
- 需要某条详情时：用 get_bug 传入编号（如 BH-1017）。

要求：编码和设计前先自查相关失效模式；产出代码或用例后，逐条核对是否已覆盖召回 Bug 的「测试要点」，并在说明里标注参考了哪些 BH 编号。

也可直接调用只读接口：https://bughub.vip/api/mcp/search?q=关键词、https://bughub.vip/api/mcp/taxonomy