Intro StuckThreadDetectionValve
Intro StuckThreadDetectionValve
Intro StuckThreadDetectionValve
Intro StuckThreadDetectionValve
org.apache.catalina.valves.StuckThreadDetectionValve 是 Apache Tomcat 中的一個 Valve 元件，
用來偵測處理請求耗時異常長的執行緒。這可能表示處理請求的執行緒因為無限迴圈、死鎖或長時間的外部呼叫等問題而「卡住」了。
作用與主要功能
這個 Valve 的主要目的是幫助你：
識別效能瓶頸：當執行緒處理時間超過設定的閾值時，它會記錄警告日誌，
幫助管理員發現潛在的效能問題或應用程式中無回應的部分。
防止資源耗盡：如果執行緒卡住，它們會一直佔用資源（例如資料庫連線、記憶體、CPU），
最終可能導致資源耗盡，甚至伺服器無回應或當機。該 Valve 提供這些資訊有助於防止這種情況發生。
輔助偵錯：這個 Valve 生成的日誌通常包含「卡住」執行緒的堆疊追蹤資訊，
這對於偵錯和精確定位導致問題的程式碼位置非常有價值。
主要特性與設定
StuckThreadDetectionValve 通常在 Tomcat 的 server.xml 檔案中進行設定，一般放在
最重要的屬性是 threshold。
threshold (整數，預設值：600 秒/10 分鐘)： 這個屬性定義了一個請求執行緒允許活動的最長時間（以秒為單位），
超過這個時間就會被認為是「卡住」的。如果執行緒處理請求的時間超過這個閾值，Valve 就會記錄警告。
interruptThreadThreshold (整數，預設值：-1)： 這是較新的 Tomcat 版本中引入的屬性。它指定了在偵測到執行緒「卡住」之後，
經過多長時間（以秒為單位）會中斷該執行緒。如果設定為大於 0 的值，執行緒將會收到一個 InterruptedException。
如果設定為 -1（預設值），則禁用中斷。請謹慎使用此功能，
因為中斷執行緒可能會對應用程式行為產生不可預測的副作用，尤其是當應用程式沒有優雅地處理中斷時。
工作原理
StuckThreadDetectionValve 會定期檢查活躍的請求執行緒。如果一個執行緒處理請求的時間超過了設定的 threshold，
它就會向 Tomcat 的 catalina.out（或類似的日誌檔案）中記錄一條警告訊息，
其中包含執行緒的詳細資訊和堆疊追蹤。當該執行緒最終完成時，還會記錄另一條訊息指示其完成。
日誌解讀
當你看到類似以下訊息時：
org.apache.catalina.valves.StuckThreadDetectionValve.notifyStuckThreadDetected
Thread “http-nio-8080-exec-X” (id=Y) has been active for aaaa milliseconds… and may be stuck.
這表示執行緒 http-nio-8080-exec-X 已經運行了 aaaa 毫秒，
超過了你設定的 threshold。附帶的堆疊追蹤資訊對於理解執行緒在偵測時正在做什麼至關重要。
注意事項與最佳實踐
閾值設定： 適當的 threshold 值很大程度上取決於你的應用程式預期的回應時間。過低的閾值可能會為正常運行時間較長的任務生成過多的警告，
而過高的閾值則可能會延遲發現真正的問題。一個常見的起始值是 60 秒（1 分鐘）或 120 秒（2 分鐘）。
誤報： 從 Valve 的角度來看，「卡住」的執行緒不一定表示它真的被阻塞了。
它可能只是在執行一個合法且耗時的操作（例如，生成複雜的報告、傳輸大檔案或呼叫緩慢的外部 API）。務必檢查堆疊追蹤以確定根本原因。
偵錯： 當出現「卡住執行緒」警告時，下一步通常是分析提供的堆疊追蹤。這可以指向執行緒花費時間過長的具體程式碼行。
進一步的診斷可能包括獲取 Tomcat 處理程序的完整執行緒傾印 (thread dump) 來查看所有執行緒的狀態。
interruptThreadThreshold 需謹慎使用： 只有在你確信應用程式能夠優雅地處理中斷時，才應啟用 interruptThreadThreshold。