做业务系统最怕的不是代码写不出，而是「系统挂了你最后一个知道」。

我有个内部 API，平时稳得一批，结果有天凌晨支付回调接口悄悄 500 了，用户投诉比监控报警先到。等我发现时，已经漏了几十笔单子。后来复盘，根因特别离谱：一个依赖的下游服务被重启，超时没兜底，连锁雪崩。

你能看到的，永远是用户替你踩完坑之后的反馈

。真正该有的，是一个 7×24 不睡觉的「哨兵」——每隔几分钟敲一下你的接口，状态码不对、延迟飙高、返回结构异常，立刻告警。

手动写监控不难，但难在「持续跑、会汇总、能报警、好维护」。这正好是 WorkBuddy 擅长的：把监控脚本化，把结果汇总成可读日报，把异常推到你能立刻看到的地方（企业微信、邮件、甚至机器人）。

核心就三层，全本地、零云成本：

┌─────────────┐   轮询    ┌──────────────────┐   异常    ┌──────────────┐
│  你的 API    │ ←──────→ │  health-check.js  │ ────────→ │  告警通道     │
│  /order /pay │  心跳    │  (状态码/延迟/JSON)│   汇总    │ 企微/邮件/日志 │
└─────────────┘          └──────────────────┘          └──────────────┘
                                │ 每日 09:00
                                ▼
                        WorkBuddy 汇总成「健康日报」


，改一下 URL 列表就能直接用。

 里每个接口配了「期望包含的关键字段」，这样不仅能测通不通，还能测「通了但返回不对」。

// health-check.js —— 零依赖，Node 18+ 直接跑
const ENDPOINTS = [
  { name: "支付回调", url: "https://api.example.com/pay/callback", expect: ["code", "msg"], timeout: 3000 },
  { name: "订单查询", url: "https://api.example.com/order/list",   expect: ["list"],   timeout: 3000 },
  { name: "用户中心", url: "https://api.example.com/user/info",     expect: ["uid"],    timeout: 3000 },
];

async function probe(e) {
  const t0 = Date.now();
  try {
    const ctrl = new AbortController();
    const id = setTimeout(() => ctrl.abort(), e.timeout);
    const r = await fetch(e.url, { signal: ctrl.signal });
    clearTimeout(id);
    const ms = Date.now() - t0;
    const body = await r.text();
    let ok = r.ok, missing = [];
    try {
      const j = JSON.parse(body);
      missing = e.expect.filter(k => !(k in j));
      ok = ok && missing.length === 0;
    } catch { ok = false; missing = ["响应非JSON"]; }
    return { name: e.name, ok, status: r.status, ms, missing };
  } catch (err) {
    return { name: e.name, ok: false, status: 0, ms: Date.now() - t0, missing: [err.name] };
  }
}

(async () => {
  const results = await Promise.all(ENDPOINTS.map(probe));
  const bad = results.filter(r => !r.ok);
  const lines = results.map(r =>
    `${r.ok ? "✅" : "❌"} ${r.name} ${r.status} ${r.ms}ms${r.missing.length ? " 缺:" + r.missing : ""}`);
  console.log(lines.join("\n"));
  console.log(bad.length ? `\n🚨 异常 ${bad.length} 个` : "\n全部正常");
  process.exit(bad.length ? 1 : 0);
})();


。正常退出码 0，有异常退出码 1，方便接 CI 或定时任务的失败通知。

脚本只管「测」，汇总和推送交给 WorkBuddy。我把它配成一个每日自动化，逻辑是：

可以直接给 WorkBuddy 这样的指令（Prompt 可直接复用）：

你是我的 API 哨兵。请执行 health-check.js 并读取输出：
1. 若有 ❌ 异常，立即用企业微信机器人 webhook 推送告警，文案含接口名、状态码、耗时、缺失字段；
2. 不论是否正常，生成一份「API 健康日报」Markdown：含各接口状态、平均耗时、与昨日对比、异常小结；
3. 把日报写入 daily_health_report.md。
注意：告警文案要短、一眼能看懂，别写长报告。


企业微信机器人推送只需一个 webhook POST：

curl -s -X POST "$WX_WEBHOOK" \
  -H "Content-Type: application/json" \
  -d '{"msgtype":"text","text":{"content":"🚨 API 告警：支付回调 500 3120ms 缺:[\"code\"]"}}'


 一开始阈值设太严，公网偶发 50ms 抖动就报警，一天被「狼来了」洗脑。后来延迟阈值放宽到「连续 2 次超 800ms 才算异常」，误报直接归零。核心是

异常要「持续」才告警，单次抖动只记录

 默认不超时，某次下游卡死，探针干等 30s 把整个定时任务堵死。现在每个接口显式 

 3s 超时，探针自身永远 5s 内返回。

 接口返回 200，但业务字段是空的——这种状态码监控抓不到。所以探针里加了 

 字段校验，返回结构不对一样判异常。上线后第一个月就靠这招逮到一次「订单列表返回空数组但状态码 200」的脏数据。

4. 别把告警发到自己会忽略的地方。

 邮件告警进了收件箱就被淹没。真正起作用的是企业微信群 + 手机推送，弹窗级别，想忽略都难。

相比之前「用户投诉才知情」，现在故障平均发现时间从「以小时计」压到「以分钟计」，而且有据可查。

与其等用户替你踩坑，不如让 WorkBuddy 当那个不睡觉的哨兵——脚本负责测，它负责汇总、告警、留痕，你只需要在弹窗亮起时看一眼。

本文是「WorkBuddy 实战」系列之一。

API 又半夜挂了？用 WorkBuddy 做健康监控与异常告警，故障早一步知道

痛点在哪 做业务系统最怕的不是代码写不出，而是「系统挂了你最后一个知道」。

人工智能

用WorkBuddy构建7×24小时API哨兵监控，零云成本全本地部署。Node.js探针脚本定时检测接口状态码、延迟及JSON字段完整性，异常实时推送企业微信告警，每日生成健康日报。有效过滤误报，故障发现时间从小时级降至分钟级，附完整可复用代码。

数据库

WorkBuddy 

JSON

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

API 又半夜挂了？用 WorkBuddy 做健康监控与异常告警，故障早一步知道

API 又半夜挂了？用 WorkBuddy 做健康监控与异常告警，故障早一步知道

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐