J2EE 架構師必修的六大實戰法則：服務端驗證、安全內建與架構治理精要

前言：拒絕陳規，直擊架構師痛點

市面上充斥「每日構建」「全自動測試」「接口導向設計」等泛泛之談。本文針對**技術架構師**視角，摒棄基礎工程規範，聚焦六大**實戰驗證、高誤區、高收益**的架構法則，附代碼級案例剖析。

法則一：切勿繞過服務端驗證 —— 安全的最後防線

1. 客戶端驗證 ≠ 安全驗證

• 客戶端驗證：用戶體驗優化（即時反饋、減少往返），**可被繞過**（禁用 JS、偽造 HTTP 請求、自定義客戶端）
• 服務端驗證：業務完整性與安全保障，**不可或缺**

2. 經典 SQL 注入案例

// ❌ 服務端僅拼接字符串，無參數化、無驗證
String sql = "SELECT * FROM SecurityTable WHERE username = '" 
           + request.getParameter("username") 
           + "' AND password = '" 
           + request.getParameter("password") + "'";

攻擊輸入：username = "admin'--" → SQL 變為 WHERE username = 'admin'--' AND password = ...，註釋掉密碼檢查，繞過登錄。

3. 正確姿勢

// ✅ PreparedStatement + 服務端業務規則校驗
String sql = "SELECT * FROM SecurityTable WHERE username = ? AND password = ?";
PreparedStatement ps = conn.prepareStatement(sql);
ps.setString(1, validateUsername(request.getParameter("username"))); // 長度、字符集、格式
ps.setString(2, validatePassword(request.getParameter("password")));

結論：SSL、防火牆、客戶端驗證都無法替代服務端參數化查詢與業務規則校驗。

法則二：安全並非附加物 —— 從設計之初內建安全

1. 典型反模式：JSP 混雜業務與授權

<% 
  if (user.hasRole("admin")) { %>
    <a href="/admin/deleteUser">刪除用戶</a>
<% } %>

問題：授權邏輯分散在視圖層，難以審計、復用、單元測試。

2. 正確架構：聲明式安全 + 切面攔截

• 方法級註解：@RolesAllowed("ADMIN") / Spring Security @PreAuthorize
• 過濾器鏈統一認證授權，業務代碼零侵入
• 策略外部化：XACML/PDP 動態決策，無需重新部署

法則三：異常處理統一化 —— 別讓堆棧跟蹤洩露系統細節

• 定義統一異常碼體系（業務碼、HTTP 狀態碼、用戶提示、日誌級別）
• 全局異常處理器捕獲未處理異常，記錄完整堆棧，**向客戶端返回脫敏錯誤信息**
• 禁止在前端顯示數據庫錯誤、堆棧跟蹤、服務器路徑

法則四：會話管理最小化 —— 無狀態才能橫向擴展

• 避免 HttpSession 存放大對象、業務狀態
• 採用 JWT / OAuth2 無狀態令牌，服務端無會話存儲
• 若必須有狀態：Redis 集群共享 Session，配合黏性會話降級

法則五：數據庫訪問抽象層 —— 別讓 SQL 散落業務代碼

• 強制使用 ORM (Hibernate/JPA) 或輕量模板
• 複雜查詢封裝為 Repository 方法，單元測試覆蓋
• 嚴禁在 JSP/Servlet/Controller 中拼接 SQL

法則六：架構決策記錄化 —— ADR (Architecture Decision Records)

# ADR 001: 採用 PostgreSQL 替代 Oracle
## 背景: 成本、擴展性、雲原生支持
## 決策: 全面遷移至 PostgreSQL 13+
## 後果: 需重寫存儲過程、調整分區策略、團隊培訓
## 狀態: Accepted

• 每個重大技術選型（框架、中間件、雲服務）產出一份 ADR
• 版本控制管理，新成員快速理解歷史決策邏輯
• 定期回顧，評估決策在當前業務場景下的有效性

總結：架構師的價值在於「權衡」與「治理」

結語

這六條法則非理論構想，而是無數項目踩坑後的血淚結晶。**架構師不寫業務代碼，寫的是「約束」、「標準」與「決策記錄」**。將這些法則內化為代碼審查清單、CI 門禁規則、新人入職必讀文檔，才能真正發揮治理效能。下一期將深入「領域驅動設計在 J2EE 分層架構中的落地實戰」。