0

0

如何在 Go 中使用 cron 定时执行函数(含阻塞与信号处理详解)

花韻仙語

花韻仙語

发布时间:2026-01-26 14:48:11

|

766人浏览过

|

来源于php中文网

原创

如何在 Go 中使用 cron 定时执行函数(含阻塞与信号处理详解)

本文详解 go 中使用 robfig/cron 库实现定时任务的正确姿势,重点解决程序启动后立即退出、cron 表达式误用及进程常驻问题,并提供可运行的完整示例与关键注意事项。

在 Go 中使用 github.com/robfig/cron(v2 及以下版本,注意:该库已归档,推荐生产环境迁移到 github.com/robfig/cron/v3github.com/go-co-op/gocron)实现定时任务时,一个常见误区是:调用 c.Start() 后未保持主 goroutine 活跃,导致程序瞬间退出,定时器根本来不及触发

例如原始代码中:

c.Start() // 启动调度器,但 main 函数随即结束

此时 main 函数执行完毕,整个进程终止,即使 cron 已启动也无济于事。

✅ 正确做法:保持主 goroutine 阻塞 + 合理配置表达式

首先,修正 Cron 表达式:原 "1 * * * * *" 表示「每分钟第 1 秒执行」(即每 60 秒一次),而非「每秒执行」。若需每秒触发,请使用六字段格式的 * * * * * *(robfig/cron v2 默认支持秒级,字段顺序为:秒 分 时 日 月 周)。

NeoAgent
NeoAgent

销售易推出的AI‑CRM智能体平台

下载

其次,必须让 main 函数持续运行。推荐方式是监听系统中断信号(如 Ctrl+C),优雅等待退出:

package main

import (
    "fmt"
    "os"
    "os/signal"
    "time"

    "github.com/robfig/cron"
)

func main() {
    c := cron.New()
    // ✅ 每秒执行一次(六位表达式)
    c.AddFunc("* * * * * *", RunEverySecond)

    // ✅ 在 goroutine 中启动 cron,避免阻塞 main
    go c.Start()

    // ✅ 等待 OS 信号(如 SIGINT/Ctrl+C),防止程序退出
    sig := make(chan os.Signal, 1)
    signal.Notify(sig, os.Interrupt, os.Kill)
    <-sig // 阻塞在此,直到收到信号

    fmt.Println("Shutting down...")
    c.Stop() // 可选:优雅停止调度器
}

func RunEverySecond() {
    fmt.Printf("[%s] Tick!\n", time.Now().Format("15:04:05"))
}

⚠️ 关键注意事项

  • 不要直接调用 c.Start() 同步阻塞:它会阻塞当前 goroutine,而 main 中阻塞会导致无法注册信号监听。
  • 务必使用 go c.Start() + 外部同步机制(如 signal.Notify + channel receive)。
  • 表达式字段数需匹配:robfig/cron v2 默认解析 6 字段(含秒),若误用 5 字段(如 "* * * * *"),将被解释为「每分钟执行」,且秒字段默认为 0。
  • 生产建议
    • 升级至 cron/v3(需显式启用秒级:cron.WithSeconds());
    • 或选用更活跃维护的替代库如 gocron,API 更现代、内置上下文支持与错误处理。

运行上述代码后,你将看到每秒输出一行时间戳,按下 Ctrl+C 即可安全退出。这正是构建可靠定时任务服务的基础范式。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Golang channel原理
Golang channel原理

本专题整合了Golang channel通信相关介绍,阅读专题下面的文章了解更多详细内容。

247

2025.11.14

golang channel相关教程
golang channel相关教程

本专题整合了golang处理channel相关教程,阅读专题下面的文章了解更多详细内容。

344

2025.11.17

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

547

2026.01.21

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

70

2026.01.23

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.23

yy漫画官方登录入口地址合集
yy漫画官方登录入口地址合集

本专题整合了yy漫画入口相关合集,阅读专题下面的文章了解更多详细内容。

297

2026.01.23

漫蛙最新入口地址汇总2026
漫蛙最新入口地址汇总2026

本专题整合了漫蛙最新入口地址大全,阅读专题下面的文章了解更多详细内容。

469

2026.01.23

C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

17

2026.01.23

php远程文件教程合集
php远程文件教程合集

本专题整合了php远程文件相关教程,阅读专题下面的文章了解更多详细内容。

114

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 3万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.5万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号