# OAuth 一下午就能接通，难的是让连接器一直活着

> Nango 称其提供方配置的提交中 16% 是 bug 修复，何时该用共享集成层而不自己写？

原文: https://fdetimes.net/zh/tools/nango-oauth-api-sync-build-or-buy/

据 Nango 在 2026 年 8 月发布的一篇技术文章，其提供方配置的提交中有 16% 是 bug 修复。这个数字来自厂商自己，这家公司为 1,000 多个 API 运营认证层。

即便如此，它也说明集成不是写一次就完事的工作：每接入一个新的提供方，就多一样需要长期照看的东西。

设想你是一名前线部署工程师（FDE），客户希望自己的 Agent 能读取 Jira、写入 Airtable，并监听某个 CRM 的 Webhook。第一天进展很快，但到第三周，连接开始悄无声息地失效，不报任何错误。从第二天起持续照看这些连接，正是 Nango 想替你接手的工作。

## Nango 到底承担了什么？

根据官方文档，Nango 负责 OAuth、API 密钥、令牌刷新、权限范围、权限管理和凭证存储，而这恰恰是团队通常自己构建的部分。除认证外，Nango 还承担另外三项工作。第一项是同步：让外部 API 的数据在产品、RAG 数据管道或变更检测工作流中保持最新。

函数用于按需读写（操作，即 action）。提供方的 Webhook 先经过 Nango，再转发出去或交给函数处理，因此不必为每个提供方单独搭建端点。

## 一个例子：令牌轮换如何让一切崩掉

假设你自己写了一个 Atlassian 连接器。两个 worker 同时发现访问令牌即将过期，都发出了刷新请求。worker A 拿到了一对新令牌，就在这一刻，worker B 手里的旧刷新令牌被吊销。

B 的请求失败。如果代码用 B 的结果覆盖了凭证，这个连接就废了，终端用户只能从头重新连接。

这并不是罕见情况。Nango 指出，包括 Airtable 和 Atlassian 在内的许多提供方，一签发新的刷新令牌就会吊销旧的。

要自己做对这件事，需要为每个连接加锁、原子写入令牌，并有重试机制。“许多”也意味着并非全部，所以必须逐个提供方核实这一行为。

还有一个更隐蔽的陷阱：认证失败并不总是看起来像失败。有些 API 在认证失败时仍返回 HTTP 200。自研客户端如果只检查状态码，就会报告一切正常，而同步实际上拉回的是空数据。

**要点:** 集成的难点不在第一次 API 调用，而在第二年的维护。

## 什么时候用 Nango，什么时候自建？

Nango 最适合提供方多、接入的终端客户也多的场景。这时，逐个提供方的维护工作（正是 Nango 所卖的东西）超过了学习和依赖一个平台的成本。

如果客户的 Agent 需要十个连接器，每个都要同步和 Webhook，把这一层交给 Nango，你就能把时间花在业务逻辑上。

反过来，如果客户只需要一两个内部 API，或者只有一个认证简单的提供方，自建通常更轻量。即使连接器很多，也有三点值得停下来想一想。

第一是许可证。Nango 使用 Elastic License，虽然 README 称该项目开源，但这个许可证未获 OSI 认可，客户的法务团队会想仔细读一读。

第二是运行位置。根据定价页，在客户自有基础设施中运行 Nango 属于 Enterprise 方案。如果客户要求数据不出自己的基础设施，应在第一次工作会议上提出来。

最后是成本。免费方案有硬性限制；按用量计费的方案每月 50 美元起，含 50 美元额度，每个连接 0.29 美元，每计算小时 0.72 美元，每 GB 数据传输 0.5 美元。

## 算一笔账

假设客户的产品有 50 个终端客户，每个接入 10 个连接器，就是 500 个连接，即 500 × 0.29 = 145 美元连接费，还不含计算和数据传输。如果终端客户增长到 500 个，就是 5,000 个连接、1,450 美元。

这笔账说明，决定性的变量不是连接器数量，而是终端客户数乘以连接器数。把这个数字和客户团队目前修连接器花的工程工时放在一起比较；写进方案之前再查一次定价页，因为价格可能会变。

16% 这个数字和上面的故障模式描述的是正确类型的风险，但不要把它们当成客户系统的实测数据。

## 先学什么？

学任何工具之前，先把 OAuth 学透。需要理解授权码流程、访问令牌与刷新令牌的区别、令牌轮换的原理，以及如何发现藏在 200 响应背后的认证失败。

有了这个基础，才能判断 Nango 实际替你省下了哪些工作，也能在下班时间自己处理断掉的连接。

就职业发展而言，阅读 FDE 岗位描述时，留意“integrations”“connectors”“agent tools”这类字眼，它们说明团队正背着这份负担。简历上不要只写“集成了 Jira”。

要写清楚你如何处理令牌轮换、如何发现隐藏的认证失败，以及为什么选择或不选择共享集成层。招聘经理需要看到的是在买与建之间做取舍的判断力，而不只是多会一个工具。

在客户现场，第一个要问的问题不是要不要用 Nango，而是明年会有多少个连接器、多少个终端客户接入。

**本周动手试试:**

- 打开你在生产环境中的集成代码，找到令牌刷新逻辑，回答：两个 worker 同时刷新会发生什么？
- 挑一个你调用的第三方 API，故意发送错误令牌，看返回什么状态码；如果是 200，就加上对响应体的检查
- 列出客户未来 12 个月需要的连接器，乘以将要接入的终端客户数，用这个数字比较 Nango 的费用和自行维护的工作量

## 信源

- [Nango (official homepage)](https://www.nango.dev/)

- [Intro to Nango (Nango docs)](https://nango.dev/docs/getting-started/intro-to-nango)

- [NangoHQ/nango (GitHub README)](https://github.com/NangoHQ/nango)

- [What we learned operating auth for 1,000+ APIs](https://nango.dev/blog/lessons-from-operating-api-auth-for-900-apis)

- [Nango Pricing](https://nango.dev/pricing)
