萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

AJAX 回調不執行、無錯誤、無回應?可能是序列化循環引用導致 jQuery 解析失敗

現象

  • jQuery `$.post` 呼叫 Struts2 Action
  • Action 邏輯正常,資料庫查詢成功,回傳 `Collection`
  • 瀏覽器 Network 面板**看不到回應內容** (或顯示 `canceled` / 空白)
  • JS `success` / `error` / `complete` **完全不觸發**,Console 無報錯

根因分析

  1. `Privilege` 實體包含 `Set users` (雙向關聯)
  2. `User` 實體包含 `Set privileges`
  3. 形成 **雙向循環引用** (Privilege → User → Privilege …)
  4. Struts2 預設使用 JSON Library (或 Jackson) 序列化,遇循環引用拋出異常或無限遞迴
  5. 異常發生在 **序列化階段**,Struts2 已進入 `execute()` 並回傳 `SUCCESS`,但結果串流寫入失敗
  6. 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 { ... }

除錯步驟

  1. 瀏覽器 Network → 該請求 → **Response** 標籤:若為空或 HTML 錯誤頁,即為伺服器端序列化失敗。
  2. 伺服器日誌:搜尋 `JsonMappingException`、`Could not write JSON`、`Infinite recursion`、`StackOverflowError`。
  3. 單元測試:直接呼叫 Service 方法,嘗試 `objectMapper.writeValueAsString(list)` 觀察例外。

最佳實踐原則

  • **實體不直接對外暴露**,永遠回傳 DTO/VO。
  • 雙向關聯**單側**加 `@JsonIgnore` / `@JSON(serialize=false)`。
  • 啟用 **全域例外處理器** 記錄序列化錯誤並回傳友善 JSON 錯誤碼,避免前端靜默失敗。
  • 定期執行 **序列化測試** (單元測試) 確保無循環引用。
copyright © 萬盛學電腦網 all rights reserved