SpringBoot集成Watchdog的完整步驟教學(xué)

更新時間：2025年09月02日 09:53:14 作者：風(fēng)象南

這篇文章主要為大家詳細(xì)介紹了SpringBoot中集成Watchdog的完整步驟教學(xué),文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

1. 為什么需要 Watchdog

很多 Spring Boot 應(yīng)用在生產(chǎn)環(huán)境里遇到過類似問題

看似存活，實則不可用：/actuator/health 依然返回 200，但線程池/GC 已經(jīng)徹底卡死

監(jiān)控延遲發(fā)現(xiàn)：Prometheus 抓到的是幾分鐘后的異常

人工干預(yù)成本高：只能 SSH 上去 kill -9 或重啟服務(wù)

解決思路

應(yīng)用層自檢：Actuator、線程池監(jiān)控、自愈腳本

系統(tǒng)級兜底：Linux Watchdog

本文重點介紹 如何在 Linux 上安裝配置 watchdog 并與 SpringBoot 集成

2. Linux Watchdog 簡介

Linux Watchdog 本質(zhì)是一個內(nèi)核驅(qū)動，通常通過 /dev/watchdog 設(shè)備暴露給用戶空間。
它的特點：

需要用戶進(jìn)程定時“喂狗”（寫入數(shù)據(jù)）；
一旦超過設(shè)定時間沒被喂 → Watchdog 觸發(fā)動作（重啟系統(tǒng)/關(guān)閉電源/觸發(fā) NMI 等）；
屬于 最后兜底機(jī)制，防止應(yīng)用假死。

3. 安裝與配置 Watchdog

3.1 安裝 watchdog 服務(wù)

在常見的 Linux 發(fā)行版中，watchdog 通常不是默認(rèn)安裝的，需要手動安裝：

Debian/Ubuntu：

sudo apt-get update
sudo apt-get install watchdog

CentOS/RHEL/UOS：

sudo yum install watchdog

安裝完成后，會得到：

配置文件：/etc/watchdog.conf
systemd 服務(wù)：watchdog.service

3.2 加載內(nèi)核驅(qū)動

常見的 Watchdog 驅(qū)動有：

Intel 平臺：iTCO_wdt
AMD 平臺：sp5100_tco
虛擬化環(huán)境（QEMU/KVM）：softdog

檢查是否支持：

ls /lib/modules/$(uname -r)/kernel/drivers/watchdog/

加載驅(qū)動，例如：

sudo modprobe iTCO_wdt     # Intel 芯片
sudo modprobe softdog soft_panic=1 # 如果沒有硬件 watchdog，可用軟件模擬

加載后應(yīng)該能看到設(shè)備文件：

ls /dev/watchdog*
# 輸出類似：
# /dev/watchdog  /dev/watchdog0

3.3 配置 watchdog 服務(wù)

編輯 /etc/watchdog.conf：

以下為幾項核心配置

watchdog-device = /dev/watchdog
interval = 5
max-load-1 = 24
min-memory = 1
realtime = yes
priority = 1

解釋：

watchdog-device → 使用哪個 watchdog 設(shè)備；
interval → 心跳間隔（秒）；
max-load-1 → 負(fù)載過高時觸發(fā)重啟；
min-memory → 可用內(nèi)存低于閾值時觸發(fā)重啟。

3.4 啟動并驗證服務(wù)

sudo systemctl enable watchdog
sudo systemctl start watchdog
sudo systemctl status watchdog

驗證 watchdog 是否正在運行：

dmesg | grep watchdog
# 或者：
journalctl -u watchdog

4. SpringBoot 集成 Watchdog

在系統(tǒng) watchdog 運行的基礎(chǔ)上，我們讓 SpringBoot 主動與它交互，實現(xiàn)應(yīng)用層喂狗邏輯。

Watchdog 喂狗任務(wù)

import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

@Component
public class WatchdogService implements CommandLineRunner {

    private FileOutputStream watchdog;

    @Override
    public void run(String... args) {
        // 先執(zhí)行 shell 命令安裝 softdog 并啟動 watchdog 服務(wù)
        String[] commands = {
                "modprobe -r softdog",
                "modprobe softdog soft_panic=1",
                "systemctl stop watchdog",
                "systemctl start watchdog"
        };

        for (String cmd : commands) {
            try {
                Process process = new ProcessBuilder("/bin/sh", "-c", cmd)
                        .inheritIO()  // 輸出到控制臺
                        .start();
                int exitCode = process.waitFor();
                if (exitCode != 0) {
                    System.err.println("命令失敗: " + cmd);
                }
            } catch (IOException | InterruptedException e) {
                System.err.println("執(zhí)行命令出錯: " + cmd + "，原因：" + e.getMessage());
            }
        }

        // 打開 /dev/watchdog 喂狗
        try {
            watchdog = new FileOutputStream("/dev/watchdog");
        } catch (IOException e) {
            System.err.println("無法打開 /dev/watchdog，請檢查驅(qū)動和權(quán)限");
            return;
        }

        Executors.newSingleThreadScheduledExecutor()
                .scheduleAtFixedRate(this::feedDog, 0, 5, TimeUnit.SECONDS);

        Runtime.getRuntime().addShutdownHook(new Thread(() -> {
            try {
                if (watchdog != null) {
                    watchdog.close(); // 防止誤觸發(fā)
                }
            } catch (IOException ignored) {}
        }));
    }

    private void feedDog() {
        try {
            watchdog.write("1".getBytes());
            watchdog.flush();
        } catch (IOException e) {
            System.err.println("喂狗失敗：" + e.getMessage());
        }
    }
}

工作機(jī)制：