現象
- jQuery `$.post` 呼叫 Struts2 Action
- Action 邏輯正常,資料庫查詢成功,回傳 `Collection`
- 瀏覽器 Network 面板**看不到回應內容** (或顯示 `canceled` / 空白)
- JS `success` / `error` / `complete` **完全不觸發**,Console 無報錯
根因分析
- `Privilege` 實體包含 `Set users` (雙向關聯)
- `User` 實體包含 `Set privileges`
- 形成 **雙向循環引用** (Privilege → User → Privilege …)
- Struts2 預設使用 JSON Library (或 Jackson) 序列化,遇循環引用拋出異常或無限遞迴
- 異常發生在 **序列化階段**,Struts2 已進入 `execute()` 並回傳 `SUCCESS`,但結果串流寫入失敗
- jQuery 等待 HTTP 回應,因伺服器中斷輸出 (或回傳 500 但無內容),導致 `readyState` 不到 4,回調不執行
解決方案
方案 A:序列化忽略反向關聯 (推薦,最簡單)
在 `Privilege.getUsers()` 上加註解:
@JSON(serialize = false)
public Set getUsers() { return users; }
或 Jackson:
@JsonIgnore
public Set getUsers() { return users; }
方案 B:DTO 投影 (乾淨、解耦)
public class PrivilegeDTO {
private Long id;
private String name;
// 僅需前端顯示的欄位,不含 users 集合
}
// Action 中
List dtos = privileges.stream()
.map(p -> new PrivilegeDTO(p.getId(), p.getName()))
.collect(Collectors.toList());
return dtos;
方案 C:Open Session In View / 延遲載入處理
若必須序列化關聯,確保 Hibernate Session 仍開啟 (OSIV Filter),並配置 Jackson `ObjectMapper`:
objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// 循環引用處理
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// 或使用 @JsonIdentityInfo (ObjectId 生成器)
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
class Privilege { ... }
除錯步驟
- 瀏覽器 Network → 該請求 → **Response** 標籤:若為空或 HTML 錯誤頁,即為伺服器端序列化失敗。
- 伺服器日誌:搜尋 `JsonMappingException`、`Could not write JSON`、`Infinite recursion`、`StackOverflowError`。
- 單元測試:直接呼叫 Service 方法,嘗試 `objectMapper.writeValueAsString(list)` 觀察例外。
最佳實踐原則
- **實體不直接對外暴露**,永遠回傳 DTO/VO。
- 雙向關聯**單側**加 `@JsonIgnore` / `@JSON(serialize=false)`。
- 啟用 **全域例外處理器** 記錄序列化錯誤並回傳友善 JSON 錯誤碼,避免前端靜默失敗。
- 定期執行 **序列化測試** (單元測試) 確保無循環引用。