尧图网站建设 
任务调度后端【免费下载链接】quartznetQuartz Enterprise Scheduler .NET项目地址https://gitcode.com/gh_mirrors/qu/quartznet点击查看免费下载# Quartz.NET Scheduler 调优实战名称与实例 ID、批触发获取与关闭中断全配置指南本篇技术指南以 Quartz.NET 官方教程文档《Tuning the Scheduler》位于 docs/documentation/quartz-3.x/tutorial/scheduler-builder.md为骨架结合当前仓库的源码实现系统讲解调度器Scheduler核心运行参数的配置方式实例名称与实例 ID、最大批处理大小Max Batch Size、批触发提前获取窗口以及关闭调度器时是否中断运行中作业的策略。读完本文你将掌握通过 Microsoft Hosting 扩展与手写构建两种路径完成 Scheduler 调优的完整实操方法并理解每个参数背后的底层原理与默认值约束能够为单机与集群场景做出正确的参数取舍。Scheduler 调优配置项总览原文档以一张表格概括了 Scheduler 层面的核心调优属性。结合当前仓库中 src/Quartz/Configuration/QuartzSchedulerOptions.cs 的强类型选项实现这张表可以进一步补充默认值与语义细节属性Property说明对应选项与默认值Scheduler Name实例名调度器实例名称集群环境下用于标识归属必须在一个进程内唯一QuartzSchedulerOptions.InstanceName默认QuartzSchedulerScheduler Id实例 ID调度器实例 ID集群内必须唯一可自动生成QuartzSchedulerOptions.InstanceId默认NON_CLUSTERED表示不参与集群设GenerateInstanceId true可在启动时由IInstanceIdGenerator生成Max Batch Size单次最多同时获取并运行的作业数量上限MaxBatchSize默认1InterruptJobsOnShutdown关闭时是否中断运行中的作业旧版两个布尔之一已演进为枚举ShutdownJobInterruption默认NeverInterruptJobsOnShutdownWithWait等待作业完成后再中断旧版两个布尔之二同上由ShutdownJobInterruption的取值组合表达BatchTriggerAcquisitionFireAheadTimeWindow批触发获取的提前触发时间窗口BatchTriggerAcquisitionFireAheadTimeWindow默认TimeSpan.Zero需要特别说明原文档表格中InterruptJobsOnShutdown与InterruptJobsOnShutdownWithWait对应的两个布尔属性在当前仓库版本中已被合并为单个枚举ShutdownJobInterruption见 src/Quartz/Configuration/ShutdownJobInterruption.cs。源码注释解释了这一设计决策这两个布尔值从来不是相互独立的它们共同回答四种组合的单一问题且两者同时为false时会产生与默认值等价的双重表达因此重构为枚举。下文将分别讲解每种配置路径的写法。路径一Microsoft Hosting Extensions 配置AddQuartz原文档给出的 Hosting 配置示例基于较旧的QuartzOptions直赋值风格。在当前仓库中services.AddQuartz(opt ...)回调参数的类型是 src/Quartz/Configuration/IQuartzBuilder.cs 中的IQuartzBuilder调度器自身参数统一通过ConfigureScheduler(ActionQuartzSchedulerOptions)配置且所有选项均为强类型属性不再需要给字符串属性赋空字符串占位。一个可编译、可运行的正确写法如下var host Host.CreateDefaultBuilder() .ConfigureServices(services { services.AddQuartz(q { // 调度器自身核心参数名称、ID、批处理与关闭中断 q.ConfigureScheduler(options { options.InstanceName myScheduler; // 进程内唯一 options.InstanceId node-01; // 集群内唯一或置 GenerateInstanceId true options.MaxBatchSize 2; // 单批最多获取 2 个触发器 options.BatchTriggerAcquisitionFireAheadTimeWindow TimeSpan.FromMilliseconds(100); // 允许提前 100ms 合并进本批 options.ShutdownJobInterruption ShutdownJobInterruption.Always; // 无论是否等待都向运行中作业发出中断 }); // 配套基础组件按需选择 q.UseDefaultThreadPool(maxConcurrency: 10); q.UseInMemoryStore(); }); }) .Build();要点说明IQuartzBuilder是两条配置路径共享的同一套 API。QuartzSchedulerBuilder.Create的回调与AddQuartz的回调完全一致见 src/Quartz/QuartzSchedulerBuilder.cs 的类注释The two paths are the same call written around a different receiver因此 Hosting 下能用的配置手写构建下同样可用二者不会漂移。与MaxBatchSize配套通常还应配置线程池并发上限UseDefaultThreadPool(maxConcurrency: ...)因为QuartzSchedulerOptions注释明确要求MaxBatchSize不得超过ThreadPoolOptions.MaxConcurrency——被获取却无线程可跑的触发器会被本节点持有、其他节点无法触发直到线程池排空。配置不限于代码IQuartzBuilder的成员与配置键使用同一词汇表例如Quartz:ThreadPool:MaxConcurrency与ThreadPoolOptions.MaxConcurrency是同一配置的两种说法代码优先与配置文件描述的是同一套语言。路径二Building By Hand手写构建调度器原文档展示了ScheduleBuilder().Create()加With*链式方法的写法这是早期 3.x 版本的 API。在当前仓库中手写构建的统一入口是QuartzSchedulerBuilder见 src/Quartz/QuartzSchedulerBuilder.cs它专门面向没有宿主容器的控制台应用、测试与任何不依赖 Host 的调用方。IScheduler scheduler await QuartzSchedulerBuilder .Create(q q .ConfigureScheduler(options { options.InstanceName console-scheduler; options.InstanceId console-node; options.MaxBatchSize 4; options.BatchTriggerAcquisitionFireAheadTimeWindow TimeSpan.FromMilliseconds(500); options.ShutdownJobInterruption ShutdownJobInterruption.WhenWaitingForJobs; }) .UseDefaultThreadPool(maxConcurrency: 8) .UseInMemoryStore()) .BuildScheduler();QuartzSchedulerBuilder的几个关键能力终端方法Build()返回StandaloneSchedulerFactory持有构建出的容器Dispose 它会一并关闭调度器BuildScheduler()直接返回IScheduler适合与进程同寿命的调度器见 src/Quartz/QuartzSchedulerBuilder.cs。配置来源UseProperties(NameValueCollection)接收扁平的quartz.*键值对——这正是从 3.xStdSchedulerFactory迁移来的调用方手中已持有的数据结构UseConfiguration(IConfiguration)读取配置节二者是AddQuartz(properties)与AddQuartz(configuration)的独立版对应物。键会被对照 Quartz 实际读取的键校验拼写错误会直接报错而不是静默忽略可设quartz.checkConfiguration false放行自定义键。优先级规则代码中写入的配置总是优先——UseProperties/UseConfiguration提供的值先被应用Create回调里的代码后应用last-wins注册类实现则是 first-wins代码选定的实现压过字符串命名的实现。源码级原理名称与实例 ID 如何参与集群QuartzSchedulerOptions对名称与 ID 的定义src/Quartz/Configuration/QuartzSchedulerOptions.csInstanceName调度器名称must be unique within the process进程内唯一默认QuartzScheduler。它是调度器在进程内的身份标识。InstanceId调度器 IDmust be unique within a cluster集群内唯一默认NON_CLUSTERED——保留该默认值即表示不参与集群。GenerateInstanceId为true时InstanceId不再取字面值而是在启动时由注册的Extensibility.IInstanceIdGenerator生成。IQuartzBuilder.UseInstanceIdGeneratorT()的注释src/Quartz/Configuration/IQuartzBuilder.cs补充了两点关键语义选择生成器等价于设置GenerateInstanceId即旧配置quartz.scheduler.instanceId AUTO的强类型说法并且只有集群化的调度器才会真正调用生成器——不与其他节点共享数据库的调度器没有区分彼此的必要其 ID 保持NON_CLUSTERED不变。因此在集群部署中每个节点应设置唯一的InstanceId或开启自动生成并配合持久化 JobStore 与聚类配置使用单机部署则维持默认值即可。源码级原理MaxBatchSize 与 FireAheadTimeWindow 是一枚硬币的两面QuartzSchedulerOptions对两个批处理参数的注释src/Quartz/Configuration/QuartzSchedulerOptions.cs是理解它们的最佳材料MaxBatchSize默认1。默认值 1 恰好也是数据库存储无需集群锁即可获取的临界点一旦调大每一次获取循环都会获取TRIGGER_ACCESS行锁包括什么都没获取到的循环。在触发器确实成批到达的场景下它物有所值在触发器稀疏的场景下则徒增锁流量。它只是上限。决定每批实际大小的是BatchTriggerAcquisitionFireAheadTimeWindow首枚触发器之后只有到期时间落在该窗口内的触发器才会加入同一批该窗口默认TimeSpan.Zero。因此单独调大MaxBatchSize不会改变有效批大小——任何触发时间错开的调度其有效批仍然是一枚触发器。源码注释的原话是the two are one setting in two halves, so move them together两者是一个设置的两半应一起调整。调宽窗口的代价是触发器可能提前最多该时长触发fires triggers early by up to this much这正是批处理换来的取舍。获取逻辑的实际执行位于 src/Quartz/Core/QuartzSchedulerThread.cs调度线程按批从 JobStore 获取到期触发器批大小与窗口的强类型选项最终经 src/Quartz/Configuration/QuartzServiceRegistration.cs 注册进调度器资源src/Quartz/Core/QuartzSchedulerResources.cs。实操建议只有当业务上存在同一时刻或极短时间窗内会到期大量触发器例如整点批量结算、批量通知时才调大MaxBatchSize并同步放宽窗口常规按需触发的应用保持默认值 1 与TimeSpan.Zero即可避免无谓的锁竞争。源码级原理关闭调度器时如何中断运行中的作业原文档中的InterruptJobsOnShutdown/InterruptJobsOnShutdownWithWait两个布尔在当前版本中由ShutdownJobInterruption枚举统一表达src/Quartz/Configuration/ShutdownJobInterruption.cs枚举值语义Never默认运行中的作业从不被中断WhenNotWaitingForJobs仅在不等待作业完成的关闭中中断——既然不等待总比把作业丢下无人汇报强WhenWaitingForJobs仅在等待作业完成的关闭中中断——等待仍然发生作业被请求停止后被给予足够时间优雅收尾Always无论是否等待一律中断该决策在调度器关闭路径中的实际执行位于 src/Quartz/Core/QuartzScheduler.csbool interruptRunningJobs resources.ShutdownJobInterruption switch { ShutdownJobInterruption.Always true, ShutdownJobInterruption.WhenWaitingForJobs waitForJobsToComplete, ShutdownJobInterruption.WhenNotWaitingForJobs !waitForJobsToComplete, _ false, };即Always恒为 trueWhenWaitingForJobs在等待关闭时中断WhenNotWaitingForJobs在不等待关闭时中断。枚举注释还强调了一个重要限制只有执行上下文实现了IInterruptableJobExecutionContext的作业才会收到信号忽略自身取消令牌CancellationToken的作业无论该配置为何都会运行到结束。对于从旧版迁移的配置src/Quartz/Configuration/QuartzPropertyBridge.cs 中的MapShutdownJobInterruption负责把两个旧布尔映射回枚举的四种组合保证旧的quartz.scheduler.interruptJobsOnShutdown风格属性仍能被正确理解。参数校验与取值范围配置并非写什么是什么。当前仓库通过 src/Quartz/Configuration/QuartzOptionsValidators.cs 对关键参数做启动期校验MisfireThreshold误触发阈值至少为 1ms且不得超过TimerLimits.MaxDelay。注意该参数在原文档语境中由调度器层级的WithMisfireThreshold(TimeSpan.FromDays(1))设置而在当前仓库中它已下沉为 JobStore 级选项内存存储默认 5 秒src/Quartz/Configuration/InMemoryJobStoreOptions.csADO 持久化存储默认 1 分钟src/Quartz/Configuration/AdoJobStoreOptions.cs集群心跳的CheckinMisfireThreshold默认 7.5 秒src/Quartz/Configuration/ClusteringOptions.cs。这属于调度器调优主题下随版本演进而迁移的配置归属配置时请按当前仓库的选项结构写入对应 JobStore 节点。校验失败时会在构建阶段报错Build()中以ValidateOnBuild true构建容器见 src/Quartz/QuartzSchedulerBuilder.cs将配置错误提前到启动期暴露而不是运行期才出现难以定位的异常。配置优先级速记综合QuartzSchedulerBuilder与IQuartzBuilder的注释Scheduler 调优配置的生效优先级可归纳为代码中写入的选项值覆盖配置文件/属性字典options 为 last-wins代码在UseProperties/UseConfiguration之后应用代码中选择的实现覆盖字符串命名的实现registrations 为 first-wins什么都没配置的属性落到QuartzSchedulerOptions的默认值QuartzScheduler/NON_CLUSTERED/MaxBatchSize 1/FireAhead Zero/ShutdownJobInterruption.Never。小结Scheduler 调优本质上是五类参数的组合决策进程内/集群内的身份标识InstanceName/InstanceId/GenerateInstanceId、单批触发获取的规模MaxBatchSize与BatchTriggerAcquisitionFireAheadTimeWindow必须成对调整、关闭时的中断策略ShutdownJobInterruption四值枚举、线程池并发上限UseDefaultThreadPool(maxConcurrency)约束批大小的天花板以及误触发阈值的归属已迁移至 JobStore 级选项。无论走AddQuartz的 Hosting 路径还是QuartzSchedulerBuilder.Create的手写路径配置的都是同一套强类型选项src/Quartz/Configuration/QuartzSchedulerOptions.cs且均可由扁平quartz.*属性或配置节提供。结合源码中批大小与窗口是一体两面TRIGGER_ACCESS行锁随批大小放大中断信号仅对可中断作业生效等实现事实开发者可以在单机与集群、吞吐与锁开销之间做出有依据的取舍而不是盲目调参。赞分享任务调度后端【免费下载链接】quartznetQuartz Enterprise Scheduler .NET项目地址https://gitcode.com/gh_mirrors/qu/quartznet点击查看免费下载相关推荐Quartz.NET 多触发器配置实战指南Quartz.NET 多触发器配置实战指南 理解 Quartz.NET 的多触发器机制 Quartz.NET 作为一个功能强大的作业调度库提供了灵活的触发器配任务调度后端Quartz.NET 3.3 版本解读.NET Framework 兼容性调整、JobStore 触发获取性能优化与 JobInterruptMonitorPlugin 实战Quartz.NET 3.3 版本解读.NET Framework 兼容性调整、JobStore 触发获取性能优化与 JobInterruptMonitorP任务调度后端PyGithub Issue 操作实战指南获取、创建、评论与批量关闭 GitHub IssuePyGithub Issue 操作实战指南获取、创建、评论与批量关闭 GitHub Issue 导读 本文基于 PyGithubTyped interact开发工具上一篇Titans-PyTorch开源项目安装与配置指南下一篇Titans-PyTorch 项目使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Quartz.NET Scheduler 调优实战：名称与实例 ID、批触发获取与关闭中断全配置指南
任务调度后端【免费下载链接】quartznetQuartz Enterprise Scheduler .NET项目地址https://gitcode.com/gh_mirrors/qu/quartznet点击查看免费下载# Quartz.NET Scheduler 调优实战名称与实例 ID、批触发获取与关闭中断全配置指南本篇技术指南以 Quartz.NET 官方教程文档《Tuning the Scheduler》位于 docs/documentation/quartz-3.x/tutorial/scheduler-builder.md为骨架结合当前仓库的源码实现系统讲解调度器Scheduler核心运行参数的配置方式实例名称与实例 ID、最大批处理大小Max Batch Size、批触发提前获取窗口以及关闭调度器时是否中断运行中作业的策略。读完本文你将掌握通过 Microsoft Hosting 扩展与手写构建两种路径完成 Scheduler 调优的完整实操方法并理解每个参数背后的底层原理与默认值约束能够为单机与集群场景做出正确的参数取舍。Scheduler 调优配置项总览原文档以一张表格概括了 Scheduler 层面的核心调优属性。结合当前仓库中 src/Quartz/Configuration/QuartzSchedulerOptions.cs 的强类型选项实现这张表可以进一步补充默认值与语义细节属性Property说明对应选项与默认值Scheduler Name实例名调度器实例名称集群环境下用于标识归属必须在一个进程内唯一QuartzSchedulerOptions.InstanceName默认QuartzSchedulerScheduler Id实例 ID调度器实例 ID集群内必须唯一可自动生成QuartzSchedulerOptions.InstanceId默认NON_CLUSTERED表示不参与集群设GenerateInstanceId true可在启动时由IInstanceIdGenerator生成Max Batch Size单次最多同时获取并运行的作业数量上限MaxBatchSize默认1InterruptJobsOnShutdown关闭时是否中断运行中的作业旧版两个布尔之一已演进为枚举ShutdownJobInterruption默认NeverInterruptJobsOnShutdownWithWait等待作业完成后再中断旧版两个布尔之二同上由ShutdownJobInterruption的取值组合表达BatchTriggerAcquisitionFireAheadTimeWindow批触发获取的提前触发时间窗口BatchTriggerAcquisitionFireAheadTimeWindow默认TimeSpan.Zero需要特别说明原文档表格中InterruptJobsOnShutdown与InterruptJobsOnShutdownWithWait对应的两个布尔属性在当前仓库版本中已被合并为单个枚举ShutdownJobInterruption见 src/Quartz/Configuration/ShutdownJobInterruption.cs。源码注释解释了这一设计决策这两个布尔值从来不是相互独立的它们共同回答四种组合的单一问题且两者同时为false时会产生与默认值等价的双重表达因此重构为枚举。下文将分别讲解每种配置路径的写法。路径一Microsoft Hosting Extensions 配置AddQuartz原文档给出的 Hosting 配置示例基于较旧的QuartzOptions直赋值风格。在当前仓库中services.AddQuartz(opt ...)回调参数的类型是 src/Quartz/Configuration/IQuartzBuilder.cs 中的IQuartzBuilder调度器自身参数统一通过ConfigureScheduler(ActionQuartzSchedulerOptions)配置且所有选项均为强类型属性不再需要给字符串属性赋空字符串占位。一个可编译、可运行的正确写法如下var host Host.CreateDefaultBuilder() .ConfigureServices(services { services.AddQuartz(q { // 调度器自身核心参数名称、ID、批处理与关闭中断 q.ConfigureScheduler(options { options.InstanceName myScheduler; // 进程内唯一 options.InstanceId node-01; // 集群内唯一或置 GenerateInstanceId true options.MaxBatchSize 2; // 单批最多获取 2 个触发器 options.BatchTriggerAcquisitionFireAheadTimeWindow TimeSpan.FromMilliseconds(100); // 允许提前 100ms 合并进本批 options.ShutdownJobInterruption ShutdownJobInterruption.Always; // 无论是否等待都向运行中作业发出中断 }); // 配套基础组件按需选择 q.UseDefaultThreadPool(maxConcurrency: 10); q.UseInMemoryStore(); }); }) .Build();要点说明IQuartzBuilder是两条配置路径共享的同一套 API。QuartzSchedulerBuilder.Create的回调与AddQuartz的回调完全一致见 src/Quartz/QuartzSchedulerBuilder.cs 的类注释The two paths are the same call written around a different receiver因此 Hosting 下能用的配置手写构建下同样可用二者不会漂移。与MaxBatchSize配套通常还应配置线程池并发上限UseDefaultThreadPool(maxConcurrency: ...)因为QuartzSchedulerOptions注释明确要求MaxBatchSize不得超过ThreadPoolOptions.MaxConcurrency——被获取却无线程可跑的触发器会被本节点持有、其他节点无法触发直到线程池排空。配置不限于代码IQuartzBuilder的成员与配置键使用同一词汇表例如Quartz:ThreadPool:MaxConcurrency与ThreadPoolOptions.MaxConcurrency是同一配置的两种说法代码优先与配置文件描述的是同一套语言。路径二Building By Hand手写构建调度器原文档展示了ScheduleBuilder().Create()加With*链式方法的写法这是早期 3.x 版本的 API。在当前仓库中手写构建的统一入口是QuartzSchedulerBuilder见 src/Quartz/QuartzSchedulerBuilder.cs它专门面向没有宿主容器的控制台应用、测试与任何不依赖 Host 的调用方。IScheduler scheduler await QuartzSchedulerBuilder .Create(q q .ConfigureScheduler(options { options.InstanceName console-scheduler; options.InstanceId console-node; options.MaxBatchSize 4; options.BatchTriggerAcquisitionFireAheadTimeWindow TimeSpan.FromMilliseconds(500); options.ShutdownJobInterruption ShutdownJobInterruption.WhenWaitingForJobs; }) .UseDefaultThreadPool(maxConcurrency: 8) .UseInMemoryStore()) .BuildScheduler();QuartzSchedulerBuilder的几个关键能力终端方法Build()返回StandaloneSchedulerFactory持有构建出的容器Dispose 它会一并关闭调度器BuildScheduler()直接返回IScheduler适合与进程同寿命的调度器见 src/Quartz/QuartzSchedulerBuilder.cs。配置来源UseProperties(NameValueCollection)接收扁平的quartz.*键值对——这正是从 3.xStdSchedulerFactory迁移来的调用方手中已持有的数据结构UseConfiguration(IConfiguration)读取配置节二者是AddQuartz(properties)与AddQuartz(configuration)的独立版对应物。键会被对照 Quartz 实际读取的键校验拼写错误会直接报错而不是静默忽略可设quartz.checkConfiguration false放行自定义键。优先级规则代码中写入的配置总是优先——UseProperties/UseConfiguration提供的值先被应用Create回调里的代码后应用last-wins注册类实现则是 first-wins代码选定的实现压过字符串命名的实现。源码级原理名称与实例 ID 如何参与集群QuartzSchedulerOptions对名称与 ID 的定义src/Quartz/Configuration/QuartzSchedulerOptions.csInstanceName调度器名称must be unique within the process进程内唯一默认QuartzScheduler。它是调度器在进程内的身份标识。InstanceId调度器 IDmust be unique within a cluster集群内唯一默认NON_CLUSTERED——保留该默认值即表示不参与集群。GenerateInstanceId为true时InstanceId不再取字面值而是在启动时由注册的Extensibility.IInstanceIdGenerator生成。IQuartzBuilder.UseInstanceIdGeneratorT()的注释src/Quartz/Configuration/IQuartzBuilder.cs补充了两点关键语义选择生成器等价于设置GenerateInstanceId即旧配置quartz.scheduler.instanceId AUTO的强类型说法并且只有集群化的调度器才会真正调用生成器——不与其他节点共享数据库的调度器没有区分彼此的必要其 ID 保持NON_CLUSTERED不变。因此在集群部署中每个节点应设置唯一的InstanceId或开启自动生成并配合持久化 JobStore 与聚类配置使用单机部署则维持默认值即可。源码级原理MaxBatchSize 与 FireAheadTimeWindow 是一枚硬币的两面QuartzSchedulerOptions对两个批处理参数的注释src/Quartz/Configuration/QuartzSchedulerOptions.cs是理解它们的最佳材料MaxBatchSize默认1。默认值 1 恰好也是数据库存储无需集群锁即可获取的临界点一旦调大每一次获取循环都会获取TRIGGER_ACCESS行锁包括什么都没获取到的循环。在触发器确实成批到达的场景下它物有所值在触发器稀疏的场景下则徒增锁流量。它只是上限。决定每批实际大小的是BatchTriggerAcquisitionFireAheadTimeWindow首枚触发器之后只有到期时间落在该窗口内的触发器才会加入同一批该窗口默认TimeSpan.Zero。因此单独调大MaxBatchSize不会改变有效批大小——任何触发时间错开的调度其有效批仍然是一枚触发器。源码注释的原话是the two are one setting in two halves, so move them together两者是一个设置的两半应一起调整。调宽窗口的代价是触发器可能提前最多该时长触发fires triggers early by up to this much这正是批处理换来的取舍。获取逻辑的实际执行位于 src/Quartz/Core/QuartzSchedulerThread.cs调度线程按批从 JobStore 获取到期触发器批大小与窗口的强类型选项最终经 src/Quartz/Configuration/QuartzServiceRegistration.cs 注册进调度器资源src/Quartz/Core/QuartzSchedulerResources.cs。实操建议只有当业务上存在同一时刻或极短时间窗内会到期大量触发器例如整点批量结算、批量通知时才调大MaxBatchSize并同步放宽窗口常规按需触发的应用保持默认值 1 与TimeSpan.Zero即可避免无谓的锁竞争。源码级原理关闭调度器时如何中断运行中的作业原文档中的InterruptJobsOnShutdown/InterruptJobsOnShutdownWithWait两个布尔在当前版本中由ShutdownJobInterruption枚举统一表达src/Quartz/Configuration/ShutdownJobInterruption.cs枚举值语义Never默认运行中的作业从不被中断WhenNotWaitingForJobs仅在不等待作业完成的关闭中中断——既然不等待总比把作业丢下无人汇报强WhenWaitingForJobs仅在等待作业完成的关闭中中断——等待仍然发生作业被请求停止后被给予足够时间优雅收尾Always无论是否等待一律中断该决策在调度器关闭路径中的实际执行位于 src/Quartz/Core/QuartzScheduler.csbool interruptRunningJobs resources.ShutdownJobInterruption switch { ShutdownJobInterruption.Always true, ShutdownJobInterruption.WhenWaitingForJobs waitForJobsToComplete, ShutdownJobInterruption.WhenNotWaitingForJobs !waitForJobsToComplete, _ false, };即Always恒为 trueWhenWaitingForJobs在等待关闭时中断WhenNotWaitingForJobs在不等待关闭时中断。枚举注释还强调了一个重要限制只有执行上下文实现了IInterruptableJobExecutionContext的作业才会收到信号忽略自身取消令牌CancellationToken的作业无论该配置为何都会运行到结束。对于从旧版迁移的配置src/Quartz/Configuration/QuartzPropertyBridge.cs 中的MapShutdownJobInterruption负责把两个旧布尔映射回枚举的四种组合保证旧的quartz.scheduler.interruptJobsOnShutdown风格属性仍能被正确理解。参数校验与取值范围配置并非写什么是什么。当前仓库通过 src/Quartz/Configuration/QuartzOptionsValidators.cs 对关键参数做启动期校验MisfireThreshold误触发阈值至少为 1ms且不得超过TimerLimits.MaxDelay。注意该参数在原文档语境中由调度器层级的WithMisfireThreshold(TimeSpan.FromDays(1))设置而在当前仓库中它已下沉为 JobStore 级选项内存存储默认 5 秒src/Quartz/Configuration/InMemoryJobStoreOptions.csADO 持久化存储默认 1 分钟src/Quartz/Configuration/AdoJobStoreOptions.cs集群心跳的CheckinMisfireThreshold默认 7.5 秒src/Quartz/Configuration/ClusteringOptions.cs。这属于调度器调优主题下随版本演进而迁移的配置归属配置时请按当前仓库的选项结构写入对应 JobStore 节点。校验失败时会在构建阶段报错Build()中以ValidateOnBuild true构建容器见 src/Quartz/QuartzSchedulerBuilder.cs将配置错误提前到启动期暴露而不是运行期才出现难以定位的异常。配置优先级速记综合QuartzSchedulerBuilder与IQuartzBuilder的注释Scheduler 调优配置的生效优先级可归纳为代码中写入的选项值覆盖配置文件/属性字典options 为 last-wins代码在UseProperties/UseConfiguration之后应用代码中选择的实现覆盖字符串命名的实现registrations 为 first-wins什么都没配置的属性落到QuartzSchedulerOptions的默认值QuartzScheduler/NON_CLUSTERED/MaxBatchSize 1/FireAhead Zero/ShutdownJobInterruption.Never。小结Scheduler 调优本质上是五类参数的组合决策进程内/集群内的身份标识InstanceName/InstanceId/GenerateInstanceId、单批触发获取的规模MaxBatchSize与BatchTriggerAcquisitionFireAheadTimeWindow必须成对调整、关闭时的中断策略ShutdownJobInterruption四值枚举、线程池并发上限UseDefaultThreadPool(maxConcurrency)约束批大小的天花板以及误触发阈值的归属已迁移至 JobStore 级选项。无论走AddQuartz的 Hosting 路径还是QuartzSchedulerBuilder.Create的手写路径配置的都是同一套强类型选项src/Quartz/Configuration/QuartzSchedulerOptions.cs且均可由扁平quartz.*属性或配置节提供。结合源码中批大小与窗口是一体两面TRIGGER_ACCESS行锁随批大小放大中断信号仅对可中断作业生效等实现事实开发者可以在单机与集群、吞吐与锁开销之间做出有依据的取舍而不是盲目调参。赞分享任务调度后端【免费下载链接】quartznetQuartz Enterprise Scheduler .NET项目地址https://gitcode.com/gh_mirrors/qu/quartznet点击查看免费下载相关推荐Quartz.NET 多触发器配置实战指南Quartz.NET 多触发器配置实战指南 理解 Quartz.NET 的多触发器机制 Quartz.NET 作为一个功能强大的作业调度库提供了灵活的触发器配任务调度后端Quartz.NET 3.3 版本解读.NET Framework 兼容性调整、JobStore 触发获取性能优化与 JobInterruptMonitorPlugin 实战Quartz.NET 3.3 版本解读.NET Framework 兼容性调整、JobStore 触发获取性能优化与 JobInterruptMonitorP任务调度后端PyGithub Issue 操作实战指南获取、创建、评论与批量关闭 GitHub IssuePyGithub Issue 操作实战指南获取、创建、评论与批量关闭 GitHub Issue 导读 本文基于 PyGithubTyped interact开发工具上一篇Titans-PyTorch开源项目安装与配置指南下一篇Titans-PyTorch 项目使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考