在實際專案中,JSON 序列化最常見的問題之一,是物件關聯過於複雜所導致的循環參照。例如 user 物件含有 roles,而 role 又可能指回 user,若全部序列化,就可能形成無限遞迴。
有些 JSON 序列化工具預設只處理第一層集合,但當物件圖形更複雜時,仍可能發生遞迴或效能問題。這類錯誤在簡單測試中未必明顯,一旦進入正式專案,就可能突然爆發。
一種常見解法,是在不需要序列化的 getter 前加上 @JSON(serialize=false),讓序列化器忽略該屬性。這樣就能避免把循環參照或敏感資料一併輸出。
JSON 的基本規則並不複雜:物件是無序的名稱/值對集合,以 { 開始、} 結束;名稱後接冒號,項目之間以逗號分隔。真正需要花時間處理的,往往是物件關係與序列化範圍,而不是語法本身。
因此,在設計 JSON 輸出時,建議先釐清哪些欄位需要傳送,再決定序列化策略,能有效降低異常風險。