使用 Cloudflare workers 做一个定时发送消息的飞书机器人上一篇初步使用了下 Cloudflare 平

前言

上一篇介绍 Cloudflare 的文章初步使用了下 Cloudflare 平台，帮我做 CDN 加速和无限邮箱注册，本次介绍一下 Cloudflare Worker 功能，实现一个飞书每日提醒晨会的机器人。

Cloudflare Worker 介绍

Cloudflare Worker 是 Cloudflare 提供的一种 无服务器计算平台，它允许开发者在 Cloudflare 的全球边缘节点上运行 JavaScript、TypeScript、或 WebAssembly 编写的代码。其核心目标是让开发者可以更接近用户地部署代码，以获得更低延迟和更高性能的 Web 应用或 API 服务。

简单讲就是一个 Serverless 服务，写一段代码就可以直接部署完成，可以触发这个接口了。

创建项目

主要参考文档 developers.cloudflare.com/workers/get…

pnpm create cloudflare@latest my-first-worker

运行后会有一个问答形式的 CLI，选择 Worker only 和暂时不需要部署。创建好后进入项目。

cd my-first-worker
pnpm dev

src/index.ts 就是抛出函数的地方。我们打开浏览器访问这个地址也会返回这句 Hello World！

编写定时需要触发的函数

由于需要每天固定时间触发，我们需要抛出一个 scheduled 函数。

export async function isWorkday(dateStr: string): Promise<boolean> {
	try {
    const response = await fetch(`https://holiday.dreace.top/?date=${dateStr}`);
    const data = (await response.json()) as { isHoliday: boolean };
    return !data.isHoliday;
	} catch (err) {
    console.error('Failed to check workday:', err);
    // 如果接口调用失败，默认为工作日
    return true;
	}
}

async function scheduledHandler(event: ScheduledEvent, env: Env, ctx: ExecutionContext) {
	// 检查今天是否为工作日
    const today = new Date().toISOString().split('T')[0];
    const isWorkDay = await isWorkday(today);

	if (!isWorkDay) {
    console.log('今天不是工作日，无需发送消息');
    return;
	}

	await sendCardMessage();
}

async function fetchHandler(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
	return new Response('This worker only handles scheduled tasks.');
}

export default {
	fetch: fetchHandler,
	scheduled: scheduledHandler,
};

然后在 wrangler.jsonc 添加 triggers crons 配置，表示定时触发，我的需求是周一到周五每天 9.30， Cloudflare 默认是美国时区，所以要变化一下写成美国 1.30 才对应的是中国 9.30。

这里的 crons 表达式直接让 AI 老师帮忙写就好，描述好自己的需求再检查下即可。

{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "my-first-worker",
	"main": "src/index.ts",
	"compatibility_date": "2025-04-29",
	"observability": {
            "enabled": true
	},
	"triggers": {
            "crons": ["30 1 * * 1-5"]
	}
}

2025.5.9 星期五补充说明

发现周五没触发，原因也是时区问题应该修改成为 30 1 * * 0-4 周五才会触发。

然后就是发送卡片消息的主体函数部分了。你需要先在飞书添加一个自定义机器人，会给你一个 webhook 地址。

然后卡片消息可以在飞书后台配置一份富文本形式的 cardMessage。

const webhookUrl = "" // 你添加的机器人 webhook 地址

async function sendCardMessage(env: Env) {
	const nextHost = await updateNextHost(env);
	const cardMessage = {}; // 飞书卡片的富文本消息格式，可以自行去飞书后台复制一份
	try {
        const response = await fetch(webhookUrl, {
                method: 'POST',
                headers: {
                        'Content-Type': 'application/json',
                },
                body: JSON.stringify(cardMessage),
        });
        return await response.json();
	} catch (error: any) {
		return { error: error.message };
	}
}

部署上传

先执行登录命令，会打开浏览器要求你授权。

wrangler login

然后执行部署

wrangler deploy

就可以在 worker 中看到你刚刚上传的 worker 了，点进去详情还可以查看触发日志，还有各式各样的配置，十分全面，感恩 Cloudflare ~