API 类型生成与契约：tRPC、OpenAPI Codegen 与 GraphQL Codegen

Mon, 28 Sep 2026 10:00:00 +0800

引言

前后端最痛的问题是「契约漂移」：后端改了响应字段，前端还按旧类型解析，直到运行时报错才发现。解决办法有三条主流路线——tRPC（前后端同进程/同库共享类型）、OpenAPI Codegen（规范驱动生成类型）、GraphQL Codegen（由 GraphQL Schema 生成类型）。三条路线都能让「改后端字段 → 前端编译报错」，但适用场景不同。

GraphQL Schema 设计进阶：接口、联合类型与可空性策略

Sun, 27 Sep 2026 10:00:00 +0800

好的 Schema 是 GraphQL 服务的灵魂。它不仅是前后端共享的契约，更是一份团队架构决策的可执行文档。当团队从"能跑通的 Schema"走向"经得起三年演进的 Schema"时，接口（interface）、联合类型（union）、输入对象（input）、中继连接（Relay Connection）这些高级建模工具就会从"偶尔用到"变成"日常标配"。本文从工程实践出发，系统讲解 Schema 设计中容易忽略却决定长期质量的八个关键领域，并在最后一节给出可直接用于评审的设计清单。

Codegen on PlumePHP

API 类型生成与契约：tRPC、OpenAPI Codegen 与 GraphQL Codegen

引言

GraphQL Schema 设计进阶：接口、联合类型与可空性策略