JBoss 3.2.x 生產環境部署實戰指南：配置優化、數據源、日誌、熱部署全解析

JBoss 核心優勢回顧

• 開源免費、基於 JMX 微內核架構、熱部署、EJB 容器性能優異、啟動快、無需安裝 (解壓即用)。
• 版本說明：3.2.1 為過渡版本，配置與 3.0.x/4.x 差異較大，本文以 3.2.1+Tomcat 4.1.24 整合版為例 (安裝路徑 C:\jboss-3.2.1_tomcat-4.1.24，default 配置集)。

核心配置文件詳細調優

1. 數據源配置 (DataSource)

步驟：

1. 從 docs/examples/jca 複製對應數據庫模板 (如 mssql-ds.xml 本地事務 / mssql-xa-ds.xml 全局事務) 至 server/default/deploy。
2. 修改連接參數：JNDI 名、JDBC URL、驅動類、用戶/密碼、連接池大小 (min/max-pool-size)。
3. 關鍵點：java:/ 前綴表示該 JNDI 僅在 JVM 內部可見，外部客戶端無法查找。

<local-tx-datasource>
  <jndi-name>VSSDB</jndi-name>
  <connection-url>jdbc:microsoft:sqlserver://125.16.45.158:1433;DatabaseName=DDD</connection-url>
  <driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>
  <user-name>sa</user-name>
  <password>sa</password>
  <min-pool-size>50</min-pool-size>
  <max-pool-size>200</max-pool-size>
</local-tx-datasource>

CMP 實體 Bean 映射：修改 standardjbosscmp-jdbc.xml，設置 <datasource>java:/VSSDB</datasource> 及 <datasource-mapping>MS SQLSERVER2000</datasource-mapping>。

2. 日誌系統調優 (Log4j)

編輯 server/default/conf/log4j.xml：

• 控制台輸出級別：將 Threshold 從 INFO 改為 DEBUG 以查看詳細 SQL。
  <param name="Threshold" value="DEBUG"/>
• Entity Bean SQL 追蹤：編輯 standardjboss.xml，將 Standard CMP 2.x EntityBean 容器的 call-logging 設置為 true。

3. Tomcat 容器參數調整

• HTTP 端口修改：編輯 deploy/jbossweb-tomcat.sar/META-INF/jboss-service.xml。
• 靜態資源映射/MIME 類型：編輯 deploy/jbossweb-tomcat.sar/web.xml。

4. 第三方庫放置規範

• 全局共享：server/default/lib (JDBC 驅動、公共工具包) —— 非 jboss根目錄/lib。
• 應用隔離：打包進 .war/WEB-INF/lib 或 .ear/lib，遵循 J2EE 類加載隔離規範。

生產環境關鍵檢查清單

1. 數據庫連接池大小匹配業務併發峰值 (監控 InUseConnectionCount 指標)。
2. 日誌級別生產環境建議 WARN 或 ERROR，問題排查時臨時調 DEBUG。
3. 啟用 JMX 遠程監控 (配置 jmx-invoker-service.xml)，對接 Prometheus/Grafana 或商業 APM。
4. 配置 JVM 參數 (run.conf)：-Xms2g -Xmx4g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -XX:+UseG1GC。
5. 定期清理 server/default/tmp、work、log 目錄，防止磁盤佔滿。
6. 集群模式下配置分佈式 Session 複製 (jboss.cache) 與單點登入 (SSO)。

熱部署最佳實踐

• 開發階段：直接將 .war/.ear/.jar 放入 deploy 目錄即時生效。
• 生產發布：建議使用 jboss-cli.sh 或管理控制台進行受控部署，支持版本回滾、滾動升級。
• 避免在高併發時段熱部署大型應用，可能導致類加載衝突或臨時性能抖動。