📂IT・資料・DX⏱閱讀 2 分鐘📊進階🔗相關 4

什麼是 GraphQL?

一句話定義
用戶端只挑選「所需資料」一次請求的 API 方式。能減少回應過多或不足的問題。
想把這個主題做成企業內訓?📚 相關課程💬 教育洽詢
⚡ 3 行重點摘要
  • 只挑選所需資料,一次請求
  • 解決回傳過多或過少的問題
  • REST 的替代方案

導入 GraphQL 後,決定「要回傳哪些資料」的權限,會從 伺服器轉移到客戶端。在 REST 下,每當畫面改動,前端就得向後端請求新的端點,還要等 部署排程;但在 GraphQL 中,只要在 schema 定義的欄位範圍內修改查詢,當天畫面就能改變。團隊之間的等待時間消失,是現場最先感受到的變化。相對地,設計與管理 schema 版本的 責任,會成為後端的新業務。

端點通常只有 /graphql 一個,操作分為查詢(Query)、變更(Mutation)、即時訂閱(Subscription)三種。與 REST 最關鍵的差異在快取。REST 以 URL 為單位,可直接使用 CDN 與瀏覽器快取;GraphQL 則是所有請求都以 POST 送到同一個位址,因此 HTTP 快取實際上幾乎無法使用。必須另外接上 Apollo 之類的用戶端快取或持久化查詢;錯誤也會夾帶在 HTTP 200 的回應內容中回傳,因此 過去依狀態碼抓故障的監控,必須從頭重新設計。

導入與否的判斷標準其實很單純。畫面上一個區塊要連續呼叫 3~4 支以上 API,且網頁・iOS・Android 等客戶端達三個以上時,效果最明顯。反之,若服務以管理後台為主、端點只有 20 個上下,REST 的維護成本會低得多。與其全面替換,在韓國更常見的折衷做法,是 只在 BFF 層加上 GraphQL,包覆既有的 REST。

最常見的誤解是「一次取得,所以一定比較快」。在伺服器內部,每 20 篇貼文都會另外查詢作者的 N+1 呼叫照樣發生;若沒有 DataLoader 就開放,資料庫連線會先耗盡。另外,客戶端可以任意指定巢狀深度,也很危險:若未設定深度・複雜度上限,單一查詢就可能讓伺服器停擺。權限也必須以 欄位為單位檢查而非以 URL,一旦漏掉,薪資或個人聯絡方式等欄位就會直接外洩,實際上確實發生過這類事故。

會出現此術語的課程 · AI・DX
推薦課程 · 推薦講師 · 迷你報價
🧮 迷你報價 · 講師費基準
約 KRW 1,200,000 (≈ US$900)專題講座 2 小時 · 20 人以下 · 韓語
依此條件取得正式報價 →
💡 簡單來說
就像自助餐只挑選想吃的菜——精準取得所需的資料。
為什麼在實務上很重要
只高效取得所需資料的 API 方式。與 REST 並用,可拓展資料整合的選擇。
由來與出處

由臉書(Facebook)於 2012 年內部開發、2015 年公開的 API 查詢語言,將客戶端精準請求所需資料的方式予以標準化。

出處 · Facebook,GraphQL(2015 年公開) · 查看原文
透過案例理解

以下以假設案例說明。A 公司是員工 320 名、年營收 KRW 180,000,000,000 (≈ US$134,724,500) 的時尚電商。App 商品詳情頁光是載入一個畫面,就要呼叫 7 次 REST API,平均載入時間拉長到 2.8 秒;每次企劃變更都要重新開端點,部署也因此每次延後兩週。CTO 於是交付了一項為期三個月的改善專案。

  1. 行動開發組的 Kim 組長調出進入紀錄後發現,商品詳情頁單一畫面就發出 7 次呼叫,LTE 環境下的平均載入時間為 2.8 秒,首頁跳出率則為 18%。
  2. 後端組長反對,表示「每個畫面都開端點,要管理的位址就超過 200 個」,於是決定保留既有 REST,在 BFF 層加上 GraphQL 閘道。
  3. 前四週只把商品、評論、庫存三個領域移到 schema,結果評論列表逐筆查詢作者的 N+1 問題爆發,於是加上 DataLoader,把資料庫呼叫從 50 次減為 3 次。
  4. 開放後第 2 週,一家合作夥伴送出 6 層巢狀查詢,API 伺服器 CPU 飆升到 92%,當晚就套用了查詢深度 5、複雜度 1,000 的上限,以及持久化查詢(persisted query)。
  5. 3 個月後,商品詳情頁的呼叫次數從 7 次減為 1 次,平均載入時間從 2.8 秒降到 1.1 秒;因畫面修改而等待後端部署的件數,也從每月 11 件降至 2 件。
相關術語
與此術語相關的課程
📚數位轉型Nanum 經營顧問 企業內訓 · 面授/線上查看課程 →
是否需要針對此主題進行企業內訓?
立即取得負責人為您量身打造的課程規劃與報價。
教育洽詢
最後修訂 2026年9月13日 · 監修 金鍾赫

常見問題

不一定。資料組合複雜時很有利,但在單純的情境下,REST 更容易上手。依情況選擇使用。
概念很簡單——「只指定所需內容再取得」。實務上導入需要伺服器設定。
不一定。面對複雜的資料需求很有利,但在單純的情境下,REST 反而更簡單。
需要前期學習。建議在需求明確時再導入。