Rpc on Tarragon

11.C23 Echobind：從 GraphQL 撤到 tRPC 的量化帳（反例）

Fri, 03 Jul 2026 00:00:00 +0000

這個案例的核心責任是劃出 GraphQL 與 tRPC 各自的適用邊界、單一 TypeScript 團隊場景的量化對照。跨主題案例：GraphQL 撤退面與 tRPC 採用面共用本檔。

觀察

痛點是 double declaration：同一資料形狀要在 Prisma / Nexus / GraphQL operations / codegen types / client queries 五層宣告；三層 codegen 產出 8,200 行型別檔、常需重啟 VSCode language server；GraphQL 依賴 81.2kb、tRPC 23.7kb；Apollo normalized cache 在 mutation 後常態性要手動 refetchQueries。遷移後淨減 1,608 行。文章同時明列 tRPC 前提：「server 用 TypeScript 且與 client 共置」、無法有效服務公開第三方 API。

判讀

撤退動因是「單一團隊同時擁有前後端」時、GraphQL 的 schema 中介層變成純開銷 — schema 作為跨團隊 / 跨 client 契約才有價值、同構 TypeScript 單團隊是反指標。作者自列的 tRPC 邊界（公開 API 不適用）可直接引用、避免被讀成萬用推薦。

對應大綱

公開 API 的 GraphQL 進退（適用邊界段、反例、已引用）、styles/rpc-revival/「tRPC 與型別共享」（anchor、backlog）。

下一步路由

回模組十一案例庫。

引用源

Why we ditched GraphQL for tRPC（Echobind blog、2022）

11.C33 tRPC 設計哲學：無 schema 無 codegen 的型別共享

Fri, 03 Jul 2026 00:00:00 +0000

這個案例的核心責任是記錄 tRPC 官方自述的設計哲學、含它自己承認的前提與代價。

觀察

核心主張：「build & consume fully typesafe APIs without schemas or code generation」、靠 TypeScript 型別推導、無 codegen、無 runtime bloat、無 build pipeline。官方 FAQ 明言前提與代價：脫離 monorepo 就失去 client 與 server 一起運作的保證、替代方案是把 backend 型別發成 private npm package；動態型別輸出做不到（需 TypeScript 尚未支援的 higher-kinded types）；Netflix、Pleo 等在 production 使用。

判讀

tRPC 是「把 API 契約從 IDL 檔搬進型別系統」的極端點 — 換到零 codegen 的 DX、付出語言鎖定（TS-only）與部署形態鎖定（同倉或私有 npm 包）。教學上與 protobuf 對照：兩者都在解契約同步、一個走 schema-first 跨語言、一個走 inference-first 單語言。

對應大綱

styles/rpc-revival/「tRPC 與型別共享」（anchor、與 C23 Echobind 並用）、11.2 風格選型交叉。

下一步路由

回模組十一案例庫。

引用源

11.C34 JSON-RPC 重生：LSP 與 MCP 都選它當訊息層

Fri, 03 Jul 2026 00:00:00 +0000

這個案例的核心責任是記錄 JSON-RPC 重生場景的共同形狀：兩份現代 spec 的採用事實。

觀察

LSP spec 明文 content part 使用 JSON-RPC 描述 requests / responses / notifications、固定 jsonrpc: "2.0"、外層自訂 Content-Length header 傳輸。MCP spec 規定所有訊息 MUST follow JSON-RPC 2.0、並在其上收緊（request ID 不可為 null、同 session 不可重用）、transport 支援 stdio 與 HTTP、schema 以 TypeScript 為 source of truth。注意：LSP spec 只陳述採用、未寫選型理由段 — 教材推導理由時要標明是判讀、不是引文。

判讀

重生場景的共同形狀：本地 process 間、雙向、低頻、需要 notification 語意、且生態工具（編輯器 / agent）要求零 codegen 可自省 — 這組條件下 gRPC 的 HTTP/2 加 codegen 成本全是負資產。兩份 spec 都「在 JSON-RPC 上加約束」而非發明新協議、是「選最小夠用訊息層」的教材主軸。

對應大綱

styles/rpc-revival/「JSON-RPC 的重生場景」（anchor）、11.2 風格選型交叉。

下一步路由

回模組十一案例庫。