# 同一个 bug 第三次出现，就该修平台了

> 在 Column 这类 API 优先的银行，没有中间供应商可以甩锅，也没有人挡着你从源头修复。

原文: https://fdetimes.net/zh/guides/turn-customer-integration-friction-into-platform-fixes/

设想你是一家向开发者出售 API 的银行的第一位前线部署工程师（FDE）。入职第三周，你第三次为不同客户修同一个 bug：沙箱里一切正常，到了生产环境，一笔转账却被创建了两次。

到第三次时，你有两条路。第一条是继续逐个客户去修，这谁都能做。第二条是把这第三次重复当作数据，修掉根因，让第四个客户根本碰不到这个 bug。

本文讲的是第二条路。这项能力把 FDE 和优秀的技术支持工程师区分开来，一些金融服务公司如今已直接把它写进招聘启事。

## API 就是产品时，客户摩擦就是你的工作

Column 自称是第一家为开发者和产品团队打造的全国性特许银行。

它的 API 由 OpenAPI spec 定义，客户可以据此生成 SDK、导入 Postman 或 Insomnia，或在本地运行 mock。

这家银行还提供沙箱，开发者可以在其中编写直接操作银行账户的软件。

对 FDE 来说，最重要的细节在别处。据 Column 创始人介绍，由于银行自有核心系统和开发者平台，它不需要中间层，开发者客户直接与银行集成。中间没有供应商可以甩锅，但你想修什么的时候，中间也没有供应商挡路。

所以在这样的银行，客户卡住的任何地方，都应首先视为关于产品的信号。来自金融领域 Monumint、Bretton AI 和 ModernFi 的三份 FDE 招聘启事，虽然没有这样明说，却都把“将客户反馈带回产品”的职责交给了 FDE。

Monumint 希望 FDE 把客户反馈转化为产品改进，并让临时拼凑的快速修复成长为供数千客户使用的持久系统。

Bretton AI 要求构建连接器、配置工具和内部框架，把为单个客户打造的方案变成可复用的能力。

## 修复该放在哪一层？

难的不是修，而是决定修在哪里。可以按四层来思考，从便宜快速到昂贵持久：

| 层级 | 适用时机 | 重复转账 bug 的例子 |
|---|---|---|
| 现场修复 | 首次出现，客户被阻塞 | 修正客户代码中的重试逻辑 |
| 文档 | 反复出现，原因是理解偏差 | 在 spec 的端点描述中加入警告和示例 |
| 工具 | 文档已经写清楚，仍然反复出现 | 在上手流程中加入重试检查 |
| 平台 | 涉及客户多，风险高 | 提议由 SDK 自动附加去重键 |

经验法则：总是先在最低一层修复，让客户能继续推进，再由重复次数决定是否往上走。

ModernFi 的招聘启事说明，中间两层是实打实的 FDE 工作，而不是附带任务。那里的 FDE 负责并持续改进公开 API 文档，还要与客户成功团队合作，收集反馈并优化自助上手工具。

**要点:** 客户第三次碰到同一个 bug 时，它就不再是客户的 bug，而是平台的 bug。

## 一个完整走一遍的例子

回到开头的场景，现在把它当作一道假设练习。假设你的 API 支持幂等键，但文档只在一个很少有人看的页面上提到它。

第一个客户是一家薪酬发放初创公司。它的代码在超时后重试，却没有发送幂等键，于是生产环境网络一抖动，就会产生重复转账。沙箱暴露不出这个 bug，因为那里很少超时。

Bretton AI 描述的正是这类工作：只有系统在真实生产环境中运行后才会冒出来的边缘情况。第一周，你在现场修正了客户的重试函数。但在关闭工单之前，你在摩擦日志里加了一条记录：

```yaml
- date: 2026-10-05
  customer: payroll-startup-a
  env: production
  endpoint: POST /transfers
  symptom: 超时后转账被创建两次
  root_cause: 重试时未发送幂等键
  tag: retry-duplicate
  workaround: 修正客户端重试，用 payroll_run_id 生成幂等键
  time_spent_hours: 3
```

到第三周，又多了两条同一标签的记录。一个简短的脚本，就能把“这个 bug 好像经常出现”的感觉变成数字：

```python
import collections, yaml

entries = yaml.safe_load(open("friction_log.yaml"))
by_tag = collections.Counter(e["tag"] for e in entries)
for tag, n in by_tag.most_common():
    hours = sum(e["time_spent_hours"] for e in entries if e["tag"] == tag)
    flag = "ESCALATE" if n >= 3 else ""
    print(f"{tag:20} {n}x  {hours}h  {flag}")
```

重复三次，就上移到文档层。由于 API 由 OpenAPI spec 定义，应把警告和示例直接写进 spec 中该端点的描述，而不是再写一篇 wiki。这样，生成的 SDK、Postman collection 和客户本地的 mock 都会带上这条警告，正好出现在开发者看的地方。

接下来是工具层：在上手检查清单中加一步，“在沙箱中模拟超时，检查不会产生重复转账”。

到平台层，你为产品团队写一页提案，涵盖受影响的三个客户、花费的工时、当前的临时方案，以及让 SDK 自动附加幂等键的选项。

Bretton AI 把这称为：把客户使用产品的方式转化为工程和产品团队的洞察。

## 从明天开始自己动手

从第一张工单起就开始记摩擦日志，哪怕还看不出任何规律。没有早期数据，到第三次时你手里只有记忆。每条记录都要包含端点、环境、根因、临时方案和花费工时，因为这些正是产品团队会问的。

然后给自己定一个明确的阈值，比如重复三次，并且每周复盘日志，而不是等灵感来。达到阈值时，选择能解决根因的最低一层。

客户理解有误，就修文档；理解了却仍然出错，就需要工具。如果两者都做了，bug 还在反复出现，它就属于平台。

最常被跳过的一步，是回头告诉碰到过这个 bug 的客户：修复已经上线。这一步闭合了反馈环，也让客户更愿意继续告诉你他们卡在哪里。

## 常见陷阱

最常见的陷阱是停在现场修复层。客户满意，你也觉得自己有用，但六个月后，你只是一个跟着单个客户跑的顾问，平台还是老样子。

相反的陷阱是第一次看到问题就要求平台层修复，而此时还没有任何证据表明它会重复。

另一个陷阱是带着零散经历去开产品会。“客户经常抱怨这个”远远比不上“三个客户、九个工程工时、同一个端点”。也不要把沙箱跑通当作完成：银行里最难的 bug 往往只在生产环境出现，所以上手检查清单需要一个模拟恶劣条件的步骤。

## 把这项能力变成求职优势

阅读 FDE 招聘启事时，尤其是金融科技公司或向银行出售基础设施的公司，留意“将客户反馈转化为产品改进”“可复用”或“负责 API 文档”这类表述。

这些表述意味着公司期望你在四个层级上都能工作，而不只是修 bug。Monumint 还要求与客户现有系统集成，例如 Salesforce、nCino、Fiserv 或 Jack Henry，所以有真实集成经验的人更有优势。

在简历上，要写出完整的闭环，而不是罗列任务。比如这样一句：“通过摩擦日志发现一个影响三个客户的重试 bug，修正了 spec 和上手检查清单，并提出一项 SDK 改动，已纳入产品路线图。”它能让招聘方看到，你能从一个客户看到整个平台。

如果你还不是 FDE，可以用任何公开 API 练习这个闭环：试着做一次集成，记录卡住的地方，然后提交一份文档修复建议。

第四个客户永远不会知道自己躲过了哪个 bug。做好这件事的 FDE，在平台上留下的印记，比在支持收件箱里留下的更多。

**本周动手试试:**

- 打开过去 30 天的支持工单或客户沟通群，给每个集成问题打标签，统计哪些标签出现了三次或以上。
- 挑出最频繁的标签，写一个文档层修复：直接在该端点的 OpenAPI spec 中补充描述或示例。
- 针对同一问题给产品团队写一页提案，涵盖受影响的客户数、当前的临时方案和平台层修复。

## 信源

- [Documentation | Column Docs](https://docs.column.com/)

- [De novo Column Bank gives partners a 'sandbox' to build banking tools](https://americanbanker.com/news/de-novo-column-bank-gives-partners-a-sandbox-to-build-banking-tools)

- [Forward Deployed Engineer at Monumint | Y Combinator](https://www.ycombinator.com/companies/monumint/jobs/et9bI4n-forward-deployed-engineer)

- [Forward Deployed Engineer at Bretton AI | Y Combinator](https://www.ycombinator.com/companies/bretton-ai/jobs/E8Bd0s3-forward-deployed-engineer)

- [Forward Deployed Engineer - ModernFi | Built In NYC](https://www.builtinnyc.com/job/solutions-engineer/4745578)
