你写好了一个接口本地测试通过部署也没报错。接下来前端要调用它合作方要调用它几个月前发布的旧版 App 也还在调用它。有人带着登录令牌有人没有有人每分钟访问几次有人一秒打来几百次。后来你又加了两个实例准备把新版本先放给一小部分用户。接口里的业务代码没改多少围着它转的事情却越来越多。这些问题放在哪一层处理谁来维护改一次规则会影响多少个服务这就是我们一起学网关的起点。先从一家书店说起这套《从零构建 API 网关Apache APISIX 实战》会跟着一家虚构的线上书店——极客书城——往前走。书城、人物和对话是教学设定不是某家公司的真实事故记录。业务服务也会适当简化让我们把注意力放在请求怎么走、规则怎么生效上。刚开始书城只有一个应用。查书、登录、下单都在一起大家改完代码就发版。这个阶段我们不会为了让架构图漂亮先塞进去一个网关。业务慢慢长大图书、用户、订单拆成了不同的服务。每个服务都要检查身份、控制访问频率、记录日志。某天一段公共鉴权逻辑要改团队发现代码只改几行发布清单却拉得很长。小韩是书城的架构师负责和同事一起把这些麻烦理清楚。小郭熟悉 Nginx经常会问一句“这个 Nginx 也能做吧”后面负责运维的小暴、关注安全与开放平台的小阮也会带来各自的问题。这些疑问都值得认真回答。现有方案能解决的事情为什么要换统一入口方便了入口自己挂了怎么办规则放到网关以后业务服务是不是就什么都不用管了我们会把代价一起写出来。网关能减少重复工作也会成为需要认真维护的基础设施。理解这两面才有可能做出适合自己团队的选择。我们会沿着什么路线走全书包含开篇、八个主题篇和结语共 35 节。你可以把它看成一次随业务逐步扩展的练习。先弄清楚为什么需要网关。第 0104 章从重复鉴权的麻烦出发分清反向代理、负载均衡、API 网关等概念再认识 Apache APISIX 的整体结构。我们会比较不同方案也会讨论什么时候暂时不需要网关。接着让请求真正走过去。第 0509 章搭起实验环境从第一条路由开始逐步加入多个后端实例整理重复配置再考虑团队怎样一起管理这些规则。对象名会随着问题出现不需要提前背一张字段表。书城开始忙起来治理问题才会具体。第 1016 章会遇到旧客户端兼容、大促限流、新版本灰度、慢服务和缓存等需求。我们不仅把配置写进去还会观察请求的结果看看它到底解决了什么、没有解决什么。当 API 开始对外开放调用者也要进入视野。第 1720 章围绕消费者、认证、统一登录和 HTTPS 展开。谁能调用、凭什么调用、能调用多少是不同的问题我们会逐个拆开。然后把“能跑”推进到“出了问题能处理”。第 2127 章依次补上日志、指标、链路追踪、部署架构、服务发现、Kubernetes 和排障方法。加了网关以后我们需要知道一次请求在哪里慢下来也需要知道某个组件故障时系统还能不能继续工作。用过以后再回头看里面。第 2831 章跟着一个请求走进 APISIX观察路由匹配、配置同步和插件执行再动手扩展一个插件。前面留下的“为什么”到这里会有更具体的答案。最后把这套思路带到 AI 流量。第 3233 章讨论多个模型入口、故障切换、Token 成本和安全边界。第 34 章回看完整书城把散落在各章的选择串起来。读完以后希望你能做什么如果同事问“我们要不要上网关”希望你能先问清楚现有入口、重复逻辑和运维成本再给出判断。如果团队要接入一个新服务希望你能让请求经过网关到达后端解释匹配规则知道怎样观察失败而不仅是复制一段配置。如果一次变更涉及鉴权、限流或灰度希望你能描述它影响哪些请求、怎样验证以及出问题后怎样收回变更。如果生产环境出现超时希望你能沿着日志、指标和追踪缩小范围。你未必能立刻找到答案但应该知道下一步要看什么。更进一步你会开始理解这些能力怎样组合。当现成插件不能满足需求时也能判断是继续配置、增加扩展还是把逻辑留在业务服务里。这些能力不会在读完目录后自动出现。我们会通过实验一点点建立它们也会把实验环境的简化条件和生产环境区分开。开始前准备到哪一步就够了如果你写过 HTTP 接口能看懂基本的 JSON愿意打开终端跟着做就可以开始。前几章先讨论问题和画图不急着装一堆组件。进入动手部分以后我们主要通过 Docker Compose 启动实验环境逐步接入服务。没有用过 Lua、etcd 或 Kubernetes也不用在开篇一次补完相关背景会在需要时出现。实验基线沿用仓库中的 APISIX 3.17.x。它是这套内容选择的验证基线并不表示你所在环境就该直接升级到这个版本。遇到不同版本我们先核对差异再决定怎样调整。看实验时可以多做一个小动作在执行之前先猜一下结果。匹配路径改了请求会去哪里一个后端停了下一次访问会怎样限流规则加上以后所有请求都会受影响吗猜错一次再去看响应和日志往往比连续复制十条命令更有收获。如果一段配置没有得到预期结果先记录现象。版本、请求头、调用路径和部署方式都可能是线索。我们会把这些排查习惯放进练习里。不必一次把整张地图背下来第一次接触网关可以按顺序读。先看第 01 章的重复鉴权再跟着书城把第一个服务接进来。遇到后面才解释的名词暂时做个标记就好。如果你已经在维护网关可以先找自己正在处理的问题例如限流、灰度、可观测性或部署再回看它依赖的对象和配置方式。如果你主要负责选型建议先读认知篇再结合生产部署和结语里的检查清单。一个实验能成功只回答了“这件事能不能做”团队能不能长期维护它还需要另外一轮判断。无论走哪条路线都可以给自己留一张纸记下三件事我们当前的问题是什么现有做法的代价是什么增加网关后又多了哪些责任。这张纸会比一份很长的插件名单更接近你的工作。四格漫画带一个自己的问题出发你现在维护的服务里有没有一段逻辑在好几个地方写了好几遍如果明天要改它需要联系几个人、修改几个服务、发布几次先把它记下来。读到后面我们再回来看看哪些适合放到网关哪些仍该留在业务代码里。下一站书城要修一段鉴权逻辑。代码只有 3 行等待小韩的却是 12 个服务的发布清单。我们就从这张清单开始。