優先權等級

最後更新 2026-10-21

本頁說明五個優先權等級、同級時的排序方式，以及任務的優先權從哪裡來。

五級優先權

所有任務放在同一個最小堆中。數值越小越先執行；同級時依 startAt（入列或重新入列時間）先進先出（core/task.go:36）。

常數	數值	用途
`PriorityImmediate`	`0`	最先執行；也是 `Priority` 的零值
`PriorityHigh`	`1`	高優先；Normal 升級後的落點
`PriorityRetry`	`2`	重試專用，排在一般流量之前
`PriorityNormal`	`3`	一般任務；Low 升級後的落點
`PriorityLow`	`4`	背景任務

任務如何取得優先權

任務的優先權取自 Enqueue 傳入的 presetName 所對應 PresetConfig.Priority（core/new.go:252）；沒有逐任務指定優先權的選項。Preset 名稱不存在（含 ""）或 Preset 未設定 Priority 時，任務會拿到零值 PriorityImmediate。一般優先權的工作請定義 Preset 並明確設定 PriorityNormal。

事件	之後的優先權
`Enqueue`	Preset 的 `Priority`
等待超過升級門檻	升一級，見防飢餓自動升級
失敗且仍有重試額度	`PriorityRetry`，見執行與重試

Preset 的定義方式見 Preset。