就像是出去玩要先查店家有沒有開，可以透過直接打電話給店家、請朋友先協助確認等成本比較低的方式。在服務檢查部分，通常使用「Health Check」。

APISIX提供「主動」和「被動」的檢查機制。

• 主動：就是定期檢查上游服務節點是否健康。
• 被動：只有有請求要轉發時，才檢查並記錄。

建立健康檢查端點

爲了提供APISIX健康檢查端點，我們在「新竹百貨公司」服務節點下，再添加一個檔案充當健康檢查結果，那麼就直接取名這個檔案叫做health.json：

{"status": "health"}

接著可以透過檢查 http://新竹百貨公司.com:9080/health.json 來檢查健康狀態。(可將端口改成特定節點監聽端口，以檢查特定節點的健康狀態)

示範上設計簡單一點：只要有回傳檔案，HTTP回應狀態碼是200或201就是健康；反之找不到檔案，回應狀態碼是404就是不健康。

設定主動檢查

設定被動檢查

正常情況測試

不設定優先序，所有節點都可以去，但仍保留各自權重。測試一百次請求結果：

竹北放假

接著可以透過刪除或重新命名health.json檔案模擬檢查不健康的情況：

mv health.json unhealth.json

然後會發現APISIX的後臺記錄顯式：unhealthy HTTP increment (5/5) for '(192.168.56.3:8084)'

apisix  | 2025/09/07 15:16:48 [warn] 49#49: *1742487 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) unhealthy HTTP increment (1/5) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080
apisix  | 2025/09/07 15:16:49 [warn] 49#49: *1742616 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) unhealthy HTTP increment (2/5) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080
apisix  | 2025/09/07 15:16:50 [warn] 49#49: *1742738 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) unhealthy HTTP increment (3/5) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080
apisix  | 2025/09/07 15:16:51 [warn] 51#51: *1742873 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) unhealthy HTTP increment (4/5) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080
apisix  | 2025/09/07 15:16:52 [warn] 51#51: *1742992 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) unhealthy HTTP increment (5/5) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080

在訪問一百次看看：

這次並沒有像「從百貨公司案例，看懂 APISIX 的負載平衡魔法！」那樣白跑一趟了！

竹北大遠百颱風假仍然開業

mv unhealth.json health.json; ls

透過恢復health.json檔案，讓健康檢查重新加入節點。同樣可以在APISIX的後臺記錄看到：healthy SUCCESS increment (2/2) for '(192.168.56.3:8084)'

apisix  | 2025/09/07 15:21:29 [warn] 49#49: *1778182 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) healthy SUCCESS increment (1/2) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080
apisix  | 2025/09/07 15:21:30 [warn] 49#49: *1778310 [lua] healthcheck.lua:1150: log(): [healthcheck] (upstream#/apisix/upstreams/583310545831068350) healthy SUCCESS increment (2/2) for '(192.168.56.3:8084)', context: ngx.timer, client: 192.168.56.1, server: 0.0.0.0:9080

在拜訪一百次結果：