解決 Java request.setAttribute 空指針異常的常見原因與對策

問題背景

在 Java Web 開發中，request.setAttribute(String name, Object o) 是將數據存入請求域的常用方法。然而，開發者有時會遇到 NullPointerException，導致屬性設置失敗。這通常不是 API 本身的缺陷，而是代碼邏輯或環境配置問題。

常見原因分析

• request 對象為空：在 Servlet 的 init()、靜態代碼塊或非請求處理線程中調用，此時尚未獲得有效的 HttpServletRequest 實例。
• 變量名衝突：自定義變量名稱為 request，遮蔽了真正的請求對象，導致調用的是未初始化的引用。
• 濾器/攔截器順序錯誤：在濾器鏈中，若在 chain.doFilter() 之後嘗試設置屬性，請求可能已提交，不可再修改。

解決方案

1. 確保在 doGet/doPost、Controller 處理方法或 chain.doFilter() 之前操作 request。
2. 檢查是否存在同名局部變量，重命名避免遮蔽。
3. 參考 StackOverflow 討論：NullPointerException when setting attribute，對比代碼上下文排查。

最佳實踐建議

养成在使用前判空的習慣：if (request != null) request.setAttribute(...)；同時善用 IDE 的調試斷點，觀察 request 對象的生命週期。