您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計疑難解答

Struts2 整合 Hibernate 時 JSP 頁面空白、路徑報錯排查指南

編輯：程式設計疑難解答

常見錯誤現象

啟動項目無報錯，但訪問 JSP 返回 404 或空白頁
控制台報 No result defined for action X and result Y
URL 顯示正確但頁面不渲染，或報 HTTP Status 500 - Could not find action or result

核心原因：過濾器配置順序與攔截路徑衝突

web.xml 正確配置順序




    encodingFilter
    org.springframework.web.filter.CharacterEncodingFilter
    
        encoding
        UTF-8
    
    
        forceEncoding
        true
    


    encodingFilter
    /*




    struts2
    org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter


    struts2
    /*
    
    REQUEST
    FORWARD
    INCLUDE




    hibernateFilter
    org.springframework.orm.hibernate5.support.OpenSessionInViewFilter


    hibernateFilter
    /*

Struts2 配置常見錯誤

1. namespace 與 action 名稱不匹配




    
        /jsp/home.jsp

訪問路徑必須為：https://host:port/context/user/login.action（注意 /user 來自 namespace）

2. 結果類型錯誤導致 JSP 不渲染



/jsp/home.jsp


/jsp/home.jsp

/jsp/home.jsp

3. 通配符映射缺失方法




    /jsp/user/list.jsp
    /jsp/user/add.jsp

Hibernate 整合導致的視圖解析問題

OpenSessionInView 導致懶加載異常被吞噬

若 JSP 中訪問懶加載關聯，且 Session 已關閉，會拋出 LazyInitializationException。若全局異常處理未配置，可能表現為空白頁。

解決方案

在 Service 層初始化所需關聯（Hibernate.initialize(entity.getCollection())）
使用 @Transactional(readOnly=true) 確保事務範圍覆蓋視圖渲染
配置全局異常處理：web.xml 中 <error-page> 或 Struts2 global-results

調試檢查清單

☐ web.xml 過濾器順序：Encoding → Struts2 → Spring/Hibernate
☐ Struts2 filter-mapping 包含 FORWARD dispatcher
☐ struts.xml namespace 與 URL 路徑一致
☐ Action 類在掃描包路徑下（struts.convention.package.locators）
☐ 結果路徑以 / 開頭（相對 Web 根目錄）
☐ JSP 文件確實存在於對應目錄
☐ 無 JSP 語法錯誤（查看 Tomcat 日誌 localhost.yyyy-mm-dd.log）
☐ Hibernate Session 生命周期覆蓋視圖渲染階段

快速定位技巧


# 1. 開啟 Struts2 開發模式（struts.properties）
struts.devMode = true
struts.i18n.reload = true

# 2. 訪問 action 後檢查控制台輸出
# 關鍵日誌：[DEBUG] ... mapping.ActionMapper - Mapping request URI to action

# 3. 直接訪問 JSP 路徑驗證頁面本身無誤
https://host:port/context/jsp/home.jsp