0

0

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

霞舞

霞舞

发布时间:2026-01-26 11:31:20

|

540人浏览过

|

来源于php中文网

原创

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

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

在 Go 中通过 robfig/cron 执行定时方法时,一个典型误区是:调用 c.Start() 后未保持主 goroutine 活跃,导致程序瞬间退出——因为 cron.Start() 本身是非阻塞的,它仅启动内部调度器并返回,而 main() 函数随即结束,整个进程终止。

此外,原始示例中的 Cron 表达式 "1 * * * * *" 实际表示「每分钟第 1 秒触发一次」(共 6 字段,支持秒级精度),而非「每秒触发」,因此 RunEverySecond 实际每分钟仅打印一次,且无任何输出感知,加剧了“未生效”的错觉。

✅ 正确做法包含三个关键点:

  1. 修正 Cron 表达式:使用 "* * * * * *" 表示「每秒执行」(6 字段格式:秒 分 时 日 月 周);
  2. 异步启动调度器:用 go c.Start() 避免阻塞主线程;
  3. 主动阻塞 main goroutine:不能依赖 time.Sleep(不健壮),而应监听系统信号(如 SIGINT/SIGKILL),实现优雅退出。

以下是生产就绪的完整示例:

黑点工具
黑点工具

在线工具导航网站,免费使用无需注册,快速使用无门槛。

下载
package main

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

    "github.com/robfig/cron/v3" // 注意:推荐使用 v3 版本(原 v1 已归档,v3 更稳定)
)

func main() {
    c := cron.New()
    // ✅ 每秒执行一次(6 字段秒级 cron)
    c.AddFunc("* * * * * *", RunEverySecond)

    // ✅ 异步启动调度器
    go c.Start()

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

    fmt.Println("Shutting down cron scheduler...")
    c.Stop() // 优雅停止(v3 支持 Stop(),v1 不支持)
}

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

? 注意事项与最佳实践

  • 版本选择github.com/robfig/cron v1 已停止维护,强烈建议升级至 github.com/robfig/cron/v3(需 go get github.com/robfig/cron/v3),它支持 Stop()、上下文控制及更健壮的错误处理;
  • 表达式校验:6 字段 cron(秒级)需确保 cron.New() 使用默认选项;若用 cron.New(cron.WithSeconds()) 显式启用秒级支持(v3 中默认开启);
  • 避免资源泄漏:务必调用 c.Stop() 清理后台 goroutine(v3 支持,v1 不支持);
  • 生产环境增强:可结合 log 包替代 fmt,添加 panic 恢复机制,并将任务封装为带错误返回的函数以提升可观测性。

通过以上结构化实现,你的 Go 程序即可稳定、可控地执行周期性任务,兼具开发便捷性与生产可靠性。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

502

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

502

2023.08.10

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

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

607

2026.01.21

拼多多赚钱的5种方法 拼多多赚钱的5种方法
拼多多赚钱的5种方法 拼多多赚钱的5种方法

在拼多多上赚钱主要可以通过无货源模式一件代发、精细化运营特色店铺、参与官方高流量活动、利用拼团机制社交裂变,以及成为多多进宝推广员这5种方法实现。核心策略在于通过低成本、高效率的供应链管理与营销,利用平台社交电商红利实现盈利。

23

2026.01.26

edge浏览器怎样设置主页 edge浏览器自定义设置教程
edge浏览器怎样设置主页 edge浏览器自定义设置教程

在Edge浏览器中设置主页,请依次点击右上角“...”图标 > 设置 > 开始、主页和新建标签页。在“Microsoft Edge 启动时”选择“打开以下页面”,点击“添加新页面”并输入网址。若要使用主页按钮,需在“外观”设置中开启“显示主页按钮”并设定网址。

6

2026.01.26

苹果官方查询网站 苹果手机正品激活查询入口
苹果官方查询网站 苹果手机正品激活查询入口

苹果官方查询网站主要通过 checkcoverage.apple.com/cn/zh/ 进行,可用于查询序列号(SN)对应的保修状态、激活日期及技术支持服务。此外,查找丢失设备请使用 iCloud.com/find,购买信息与物流可访问 Apple (中国大陆) 订单状态页面。

21

2026.01.26

npd人格什么意思 npd人格有什么特征
npd人格什么意思 npd人格有什么特征

NPD(Narcissistic Personality Disorder)即自恋型人格障碍,是一种心理健康问题,特点是极度夸大自我重要性、需要过度赞美与关注,同时极度缺乏共情能力,背后常掩藏着低自尊和不安全感,影响人际关系、工作和生活,通常在青少年时期开始显现,需由专业人士诊断。

3

2026.01.26

windows安全中心怎么关闭 windows安全中心怎么执行操作
windows安全中心怎么关闭 windows安全中心怎么执行操作

关闭Windows安全中心(Windows Defender)可通过系统设置暂时关闭,或使用组策略/注册表永久关闭。最简单的方法是:进入设置 > 隐私和安全性 > Windows安全中心 > 病毒和威胁防护 > 管理设置,将实时保护等选项关闭。

5

2026.01.26

2026年春运抢票攻略大全 春运抢票攻略教你三招手【技巧】
2026年春运抢票攻略大全 春运抢票攻略教你三招手【技巧】

铁路12306提供起售时间查询、起售提醒、购票预填、候补购票及误购限时免费退票五项服务,并强调官方渠道唯一性与信息安全。

29

2026.01.26

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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号