https://plumephp.com/categories/schema-%E8%AE%BE%E8%AE%A1/Recent content in Schema 设计 on PlumePHPHugozh-CNTue, 29 Sep 2026 14:00:00 +0800https://plumephp.com/graphql-search-filtering-aggregation/Tue, 29 Sep 2026 14:00:00 +0800https://plumephp.com/graphql-search-filtering-aggregation/<p>查询能力的工程化，是 API 从&quot;能查&quot;到&quot;好用&quot;的分水岭。GraphQL 里&quot;查一组数据&quot;不只是 <code>list</code> 一个字段——客户端要过滤（只看某种状态）、搜索（关键词）、排序、分页、还要看聚合（总共有多少）。这些能力如果设计得好，客户端一次请求拿到完整结果；设计得烂，就是&quot;一次 list 全查回来，客户端在内存里过滤&quot;——既慢又泄数据。</p> <p>本文给出过滤、搜索、排序分页与聚合的 GraphQL 工程化建模：参数设计、schema 表达、性能下推、以及授权与过滤的组合。</p>https://plumephp.com/graphql-union-interface-design/Tue, 29 Sep 2026 13:00:00 +0800https://plumephp.com/graphql-union-interface-design/<p>真实业务里，一个字段的返回值常常&quot;是几种不同类型之一&quot;：消息流里有文本、图片、视频消息；支付方式有卡、支付宝、钱包；内容平台有文章、视频、播客。GraphQL 用 <strong>Interface</strong> 与 <strong>Union</strong> 表达这种多态，但在设计上它们经常被误用——要么全部塞进一个&quot;万能类型&quot;，要么 interface 当 union 用、union 当 interface 用。设计对了，多态让 schema 表达力翻倍；设计错了，就是客户端噩梦。</p> <p>本文讲清 interface 与 union 的本质区别、多态 schema 建模、客户端消费模式、性能陷阱与演进策略。</p>