Struts 2 核心配置檔 struts.properties 完整指南

struts.properties 是 Struts 2 框架的核心配置檔案，通常置於 WEB-INF/classes 目錄下。它用於定義系統層級的基本慣例與預設行為。值得注意的是，所有在 struts.properties 中設定的屬性，均可在 struts.xml 或 web.xml（透過 Filter 初始化參數）中覆寫，三者優先級遞增。

配置等價範例：國際化編碼設定

1. 在 struts.properties 中設定

struts.i18n.encoding=UTF-8

2. 等價的 struts.xml 配置

<constant name="struts.i18n.encoding" value="UTF-8" />

3. 等價的 web.xml 配置（Filter 初始化參數）

<filter>
  <filter-name>struts</filter-name>
  <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
  <init-param>
    <param-name>struts.i18n.encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
</filter>

常用配置屬性速查

最佳實務建議

• 集中管理：建議將通用系統層級設定放在 struts.properties，專案特定設定放在 struts.xml，部署環境差異（如資料庫連線）放在 web.xml 或外部化配置。
• 版本控制：struts.properties 應納入版本控制，但敏感資訊（密碼、金鑰）勿直接寫入，改用佔位符搭配外部配置中心。
• 開發/生產環境區隔：struts.devMode 開發環境設為 true，生產環境必須為 false，避免效能損耗與資訊洩露。

總結

struts.properties 是 Struts 2 系統行為的基石，掌握其與 struts.xml、web.xml 的關係與優先級，能讓配置管理更彈性、更清晰。實務上善用三層配置分工，可大幅降低維護成本。