API 接口监控怎么做？状态码 200 不代表没事，关键字检测配置指南
很多接口挂了仍然返回 200：错误页、登录页、空数据、缓存旧页都会骗过只看状态码的监控。本文讲怎么用关键字检测、超时和连续失败阈值，把真正影响用户的故障告警出来。
不能只看状态码。HTTP 200 只说明服务器返回了内容，不说明返回的是正确内容：数据库挂了返回一张「系统维护」页、登录态失效跳回登录页、CDN 缓存了旧页面、接口返回空数组，状态码都可能是 200。要发现这类故障，监控必须检查响应内容里的关键字，再配合超时、连续失败次数和恢复通知。
下面是一套可以直接照做的接口监控配置方法。
为什么 200 会骗过监控
常见的「假正常」有这几类：
- 兜底页：后端异常时框架返回一个 200 的首页或错误页，用户看到的是「页面不存在」；
- 登录跳转：接口需要登录，未登录时返回 200 的登录页 HTML；
- 空数据：查询失败被 catch 住，接口返回
{"list":[]}，页面一片空白； - 缓存旧内容：CDN 或反向代理一直吐旧响应，服务其实已经挂了；
- 证书/域名问题：某些客户端不校验证书，监控看到 200，真实用户却打不开。
只看 status == 200 的监控，对这五种情况全部失明。
关键字检测怎么配
关键字检测（Keyword Monitoring）就是定时请求一个地址，检查返回内容里有没有你指定的字符串。配置时注意六件事：
- 选一个真正代表业务正常的词。 比如首页标题里的品牌名、接口返回里的
"status":"ok"、健康检查接口里的"db":"connected"。 - 避开会变化的内容。 不要把时间戳、随机 ID、用户昵称设成关键字，否则每次都会误报。
- 同时检查不该出现的词。 有些工具支持「不存在」判断，可以把「系统维护」「请登录」「Not Found」配成异常关键字。
- 超时要短。 接口正常应在几百毫秒内返回，超时设 5~10 秒足够；设太长会让故障发现慢一拍。
- 连续失败再告警。 单次网络抖动很常见，设置连续 2~3 次失败才通知，能过滤掉大部分噪音。
- 恢复也要通知。 只报告警不报恢复，你会一直惦记着是不是还没好。
如果接口有鉴权，优先让监控访问一个专门的健康检查地址，不要在监控里存真实用户的 Token。
除了关键字，还要监控什么
一个网站出问题，往往不止接口一层。建议至少覆盖：
| 监控类型 | 能发现的问题 |
|---|---|
| HTTP / HTTPS | 页面或接口打不开、返回 5xx |
| 关键字检测 | 200 但内容是错误页、空数据、登录页 |
| TCP 端口 | 数据库、Redis、自定义服务端口不通 |
| Ping | 服务器整体不可达 |
| DNS | 域名解析失败或被改错 |
| SSL 证书 | 证书过期、域名不匹配，浏览器直接拦截 |
其中 SSL 证书过期最容易被忽略：它不会提前报错，到期当天所有用户同时打不开。
告警怎么配才不吵
- 按严重程度分渠道。 核心支付、登录接口挂掉打电话或发群；次要服务发邮件。
- 设置维护窗口。 发版、迁移期间暂停告警，避免自己把自己吵醒。
- 写清告警内容。 至少包含哪个监控项、哪个地址、连续失败几次、最后一次响应时间，别只发一句「监控异常」。
- 定期清理失效监控。 已经下线的域名还在报警，会让团队逐渐无视所有告警。
自建还是用托管服务
自己部署 Uptime Kuma 这类开源工具，优点是数据完全在自己手里、功能可定制；代价是要准备一台长期在线的服务器，还要负责升级、备份和「监控本身挂了谁监控」。
如果团队没有专职运维，托管服务更省事：开通后直接在控制台添加监控项，平台负责部署和升级。以 不墨DEV 在线监控 为例，基于 Uptime Kuma 提供托管服务，支持 HTTP/HTTPS、TCP、Ping、DNS、关键字检测，配置多通道告警，还能生成公开状态页给用户看。
从零接一个接口监控：4 步
第一步：准备检查地址。 最好单独做一个 /health 接口，返回数据库、缓存等关键依赖的状态，不要暴露敏感信息。
第二步：添加监控项。 在控制台选择 HTTP(s) 或关键字类型，填入地址和检查关键字，设置探测频率（核心服务 1 分钟，次要服务 5 分钟即可）。
第三步：绑定告警渠道。 添加通知方式，先发一条测试消息确认能收到。
第四步：观察一周再调阈值。 看误报主要来自哪里，再调整超时和连续失败次数，不要一开始就把阈值设得极敏感。
常见问题
动态页面怎么设关键字？ 选页面里稳定出现的标题、页脚版权信息或固定文案，不要选列表内容。
监控频率越高越好吗？ 不是。频率高会增加目标服务器压力，也会放大误报。核心接口 1 分钟一次通常够用，故障发现延迟最多一分钟。
监控服务器自己挂了怎么办？ 正规托管服务会在多个节点探测；自建时至少要把监控部署在业务服务器之外。
免费额度够测试吗？ 多数服务提供免费试用，可以先用几个核心接口跑通，再决定是否覆盖全部站点。
总结
接口监控的关键不是「能不能请求通」，而是「返回的内容对不对」。先给核心接口配关键字检测，再补 TCP、DNS 和证书监控，最后用连续失败阈值和恢复通知把噪音压下去。
用不墨DEV 在线监控添加第一个接口检查，托管 Uptime Kuma，开通即用。
相关阅读
证书续签后仍提示过期，或想提前收到提醒，可按SSL 证书过期与续签验收清单逐项检查。
