Web 開發中 java.io.EOFException 異常排查與快速修復

Web 開發中 java.io.EOFException 異常排查與快速修復

異常堆疊典型特徵

java.io.EOFException
嚴重: IOException while loading persisted sessions: java.io.EOFException
嚴重: Exception loading sessions from persistent storage

根因分析

Tomcat 在啟動時嘗試從磁碟恢復序列化的 Session 物件（持久化會話），讀取 work 目錄下的 .ser 檔案時遇到 檔案損壞、截斷或版本不兼容，導致輸入流意外結束 (End Of File)。

快速解決方案

1. 停止 Tomcat。
2. 進入專案部署目錄下的 work 資料夾（通常路徑：tomcat/work/Catalina/localhost/專案名/）。
3. 刪除所有 *.ser 檔案（特別是 SESSIONS.ser），或直接清空整個 work 目錄。
4. 重啟 Tomcat，問題即刻解決。

原理： 移除損壞的持久化會話數據，強制 Tomcat 建立新的 Session 存儲，避免讀取壞檔拋出 EOFException。

預防建議

• 生產環境謹慎啟用 Session 持久化（Manager 配置 pathname）。
• 定期清理 work 目錄舊檔案。
• 升級 Tomcat 版本修復已知序列化 Bug。