Spring定時任務之fixedRateString的實現(xiàn)示例

更新時間：2025年09月23日 10:46:46 作者：AlianNiew

本文主要介紹了Spring定時任務之fixedRateString的實現(xiàn)示例,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

在 Spring Framework 的開發(fā)中，@Scheduled 注解是我們實現(xiàn)定時任務的利器。其中，fixedRateString 屬性允許我們通過字符串來配置任務執(zhí)行的固定速率。從 Spring 5 開始，為了更好地支持 Java 8 的日期時間 API，fixedRateString（以及 fixedDelayString, initialDelayString）開始支持 java.time.Duration 的格式進行解析。

這為我們提供了比毫秒數(shù)字更優(yōu)雅、更易讀的配置方式。今天，我們就來深入探討一下這個強大的功能。

從毫秒到 Duration：為何要改變？

在舊版本中，我們通常這樣配置：

@Scheduled(fixedRate = 5000) // 每5秒執(zhí)行一次
public void doTask() {
    // 任務邏輯
}

或者使用字符串形式（為了支持占位符）：

@Scheduled(fixedRateString = "5000") // 從配置文件中讀取，例如：scheduled.rate=5000
public void doTask() {
    // 任務邏輯
}

這種方式雖然直接，但可讀性較差?？吹?5000，你需要反應一下才知道是 5 秒。而 Duration 格式則一目了然：

@Scheduled(fixedRateString = "PT5S") // 清晰明了：Period of Time 5 Seconds
public void doTask() {
    // 任務邏輯
}

核心：java.time.Duration.parse 支持的格式

Spring 底層使用 java.time.Duration.parse(CharSequence) 方法來解析 fixedRateString 的值。該方法遵循 ISO-8601 持續(xù)時間格式。

其正則表達式定義如下： ([-+]?)P(?:([-+]?[0-9]+)D)?(T(?:([-+]?[0-9]+)H)?(?:([-+]?[0-9]+)M)?(?:([-+]?[0-9]+)(?:[.,]([0-9]{0,9}))?S)?)?

看起來復雜，但其結(jié)構(gòu)非常清晰，可以分解為：

基本結(jié)構(gòu)： P[n]Y[n]M[n]W[n]D[T[n]H[n]M[n]S]]

P (必需): 是“Period”的縮寫，表示持續(xù)時間段的開始。
T (可選): 是“Time”的縮寫，用于分隔日期部分和時間部分。如果要指定小時、分鐘或秒，則必須有 T。

日期部分 (在 P 之后，T 之前)：

Y - 年
M - 月
W - 周
D - 天

時間部分 (在 T 之后)：

H - 小時
M - 分鐘
S - 秒 (可以包含小數(shù)，使用 . 或 , 分隔，例如 PT30.5S 是 30.5 秒)

重要提示：對于 Duration 類型，它主要用于衡量精確的時間段，而不是用于基于日歷的、不精確的時間段。因此，在解析時，年（Y） 和 月（M） 會被忽略（一個月的天數(shù)不固定，無法精確轉(zhuǎn)換為 Duration）。周（W） 和 天（D） 則會被正常轉(zhuǎn)換（1天=24小時，1周=7天）。

這意味著，雖然格式允許 Y 和 M，但在 Duration 的語境下，它們是沒有意義的。你應該專注于使用 D, H, M, S。

實戰(zhàn)示例

讓我們看一些在 @Scheduled 中有效的配置示例：

5 秒: PT5S
30 分鐘: PT30M 或 PT1800S
2 小時: PT2H
2 小時 30 分鐘: PT2H30M
1 天: P1D (相當于 PT24H)
1 天 6 小時: P1DT6H
1.5 秒 (1500毫秒): PT1.5S

從配置文件讀取:

application.properties:

my.task.rate=PT10S
my.task.delay=P1DT12H

Java Code:

@Scheduled(fixedRateString = "${my.task.rate}", initialDelayString = "${my.task.delay}")
public void doScheduledTask() {
    // 應用啟動后，先延遲 1天半 (36小時)，然后每10秒執(zhí)行一次
}

常見錯誤與陷阱

忘記 T 分隔符：
- 錯誤: P1H30M (試圖在日期部分指定小時)
- 正確: PT1H30M (必須用 T 引入時間部分)
使用 Y 或 M：
- 無效: P1M (期望是1個月，但實際會被解析為 0)
- 無效: P1Y1M (年份和月份都會被忽略，解析結(jié)果也是 0)
- 如果需要“大約一個月”這種基于日歷的概念，Duration 不是正確的工具，應考慮 Cron 表達式。
負值：格式支持負值（-PT5S），但這在調(diào)度場景中沒有意義，會導致異常。