Vercel Cron Jobs：网站定时巡检与故障通知

用 Vercel Cron Jobs 做一个免费的网站巡检：每天定时访问你的几个网站，检查状态码和页面关键字，有异常就推送到群机器人。整个项目只有一个函数和一个配置文件。

先看清成品

成品是 api/cron.js 加 vercel.json 里的 crons 配置。本文已用 Node.js 22 实际运行 2 个测试，全部通过：没有或错误的 CRON_SECRET 返回 401；本地模拟的正常页面、缺少关键字、HTTP 500 三种情况能正确区分，并向模拟 Webhook 发出一条包含两个异常的告警；带正确密钥时真实检查 example.com 返回 200。本文环境没有 Vercel 账号，Cron 没有在 Vercel 上实际触发。

注意：Vercel 的免费 Hobby 计划仅限个人、非商业用途（官方 Hobby 页面和公平使用准则写明），商业项目需要 Pro 计划。各计划额度以官方页面为准。

注意：官方文档写明，Hobby 计划的 Cron 每天只能运行一次，写成更频繁会导致部署失败，而且可能在指定小时内的任意时间触发；失败的调用不会重试。需要每几分钟检查一次的话，要升级计划或用专门的监控服务。

做完之后你会得到什么？

需要准备哪些环境？

第一步：Cron 是怎么工作的？

本文的 0 1 * * * 是 UTC 1 点，也就是北京时间 9 点左右。

第二步：代码怎么写？

1. 项目结构

uptime-cron/
├── api/cron.js
├── sites.json
├── cron.test.js
├── vercel.json
└── package.json

2. sites.json

[
  { "name": "官网", "url": "https://example.com/" },
  { "name": "博客", "url": "https://example.org/", "expect": "Example Domain" }
]

3. api/cron.js

// 每天由 Vercel Cron 调用：检查网站是否可用，有异常就发通知
import sites from '../sites.json' with { type: 'json' };

export async function checkOne(site, timeoutMs = 10000) {
  const started = Date.now();
  try {
    const r = await fetch(site.url, { signal: AbortSignal.timeout(timeoutMs), redirect: 'follow' });
    const ms = Date.now() - started;
    if (!r.ok) return { ...site, ok: false, reason: `HTTP ${r.status}`, ms };
    if (site.expect && !(await r.text()).includes(site.expect)) {
      return { ...site, ok: false, reason: `页面里没有“${site.expect}”`, ms };
    }
    return { ...site, ok: true, ms };
  } catch (e) {
    return { ...site, ok: false, reason: e.name === 'TimeoutError' ? '超时' : e.message, ms: Date.now() - started };
  }
}

export async function GET(request) {
  const secret = process.env.CRON_SECRET;
  if (!secret || request.headers.get('authorization') !== `Bearer ${secret}`) {
    return new Response('Unauthorized', { status: 401 });
  }
  return Response.json(await run(sites));
}

// 把检查逻辑单独导出，方便测试时传入自己的网站列表
export async function run(list) {
  const results = await Promise.all(list.map((s) => checkOne(s)));
  const bad = results.filter((r) => !r.ok);
  if (bad.length && process.env.ALERT_WEBHOOK_URL) {
    const text = '网站巡检异常：\n' + bad.map((b) => `${b.name} ${b.url}：${b.reason}`).join('\n');
    await fetch(process.env.ALERT_WEBHOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ text, msg_type: 'text', content: { text } }),
    });
  }
  console.log(JSON.stringify(results)); // 在 Vercel 日志里可以看到
  return { checked: results.length, failed: bad.length, results };
}

4. vercel.json

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "crons": [
    { "path": "/api/cron", "schedule": "0 1 * * *" }
  ]
}

第三步：怎样测试和部署？

1. 本地测试

import test from 'node:test';
import assert from 'node:assert/strict';
import http from 'node:http';
import { GET, run } from './api/cron.js';

let alerts = [];
const srv = http.createServer((q, s) => {
  if (q.url === '/ok') return s.end('<h1>Hello 你好</h1>');
  if (q.url === '/slow') return setTimeout(() => s.end('late'), 3000);
  if (q.url === '/hook') { let d = ''; q.on('data', c => d += c); return q.on('end', () => { alerts.push(JSON.parse(d)); s.end(); }); }
  s.statusCode = 500; s.end('err');
});
await new Promise(r => srv.listen(0, r));
const base = `http://127.0.0.1:${srv.address().port}`;
process.env.CRON_SECRET = 'test-secret-1234567890';
process.env.ALERT_WEBHOOK_URL = base + '/hook';
const auth = (v) => new Request('http://x/api/cron', { headers: v ? { authorization: v } : {} });

test('没有或错误的密钥返回 401', async () => {
  assert.equal((await GET(auth())).status, 401);
  assert.equal((await GET(auth('Bearer wrong'))).status, 401);
});

test('正常、关键字缺失、500 都能识别，并发送告警', async () => {
  const list = [
    { name: 'A', url: base + '/ok', expect: '你好' },
    { name: 'B', url: base + '/ok', expect: '不存在的字' },
    { name: 'C', url: base + '/err' },
  ];
  const j = await run(list);
  assert.equal((await GET(auth('Bearer test-secret-1234567890'))).status, 200);
  assert.equal(j.failed, 2);
  assert.match(alerts[0].text, /B .*没有/);
  assert.match(alerts[0].text, /HTTP 500/);
  srv.close();
});

npm test

本文实际输出 # pass 2、# fail 0。

2. 部署

vercel
vercel env add CRON_SECRET production      # 至少 16 位随机字符
vercel env add ALERT_WEBHOOK_URL production
vercel --prod

生成随机密钥：

openssl rand -hex 24

3. 手动触发一次

curl -H "Authorization: Bearer 你的密钥" https://你的项目.vercel.app/api/cron

期望返回 {"checked":2,"failed":0,...}。不带请求头应返回 Unauthorized。

4. 查看定时任务

项目 Settings → Cron Jobs 能看到任务列表，点 View Logs 查看每次执行的日志。

出问题时该怎么调？

1. 部署失败，提示 Cron 频率

Hobby 计划写了 */5 * * * * 这类每天多次的表达式。改成每天一次。

2. Cron 执行了但一直 401

CRON_SECRET 没加到 Production 环境，或者加了之后没重新部署。

3. 某个网站总是“超时”

可能是那个网站屏蔽了来自数据中心的访问。用自己电脑 curl -I 对比，必要时调大超时。

常见问题怎么处理？

项目资源

建议先跑 npm test，部署后用 curl 手动触发，确认能收到一次告警（可以临时放一个不存在的网址）。

确认告警正常后再换成真实网站清单，第二天到 Cron Jobs 日志里确认定时执行了。