单元测试 - Tony Bai

本文永久链接 – https://tonybai.com/2025/11/24/google-adk-go-in-action

大家好，我是Tony Bai。

上周，我花了一个下午，仅仅是为了让一个Python写的Agent能稳定地调用我Go服务里的一个简单函数。在那一刻，看着屏幕上纠缠的gRPC、Python虚拟环境和混乱的日志，我脑海里只有一个念头：这不对劲，这绝对不是软件工程该有的样子！

显然，不仅仅是我一个人在为此焦虑。

就在最近，一个名为 google/adk-go 的项目悄然开源，并迅速霸榜 GitHub Go 语言趋势榜长达一周之久！ 全球的 Gopher 似乎都在用脚投票，表达着同一个渴望：我们受够了“炼丹”，我们要回归工程！

过去的一年，AI 的浪潮席卷了整个技术圈。我们 Gopher，作为构建云原生世界的中坚力量，看着 Python 社区在 AI 领域“杀”得热火朝天，心中或许都有一个共同的疑问：

“这场 AI 的盛宴，我们 Gopher 的主菜在哪儿？”

我们习惯了用 goroutine 优雅地处理并发，用 channel 安全地传递消息，用静态编译的单个二进制文件征服任何服务器。我们是天生的“工程师”，我们信奉的是可测试、可维护、可部署的软件工程哲学。

然而，当我们尝试踏入 AI Agent 的世界时，却常常感觉自己像一个闯入了“炼丹房”的“机械师”。面对那些需要反复“吟唱咒语”（调 Prompt）、结果飘忽不定的“丹炉”（模型），我们不禁会问：

我的 Agent 行为不稳定，怎么写单元测试？
Prompt 稍微一改，整个“丹方”都可能失效，版本管理怎么做？
我如何将这个“充满魔法”的 Python 脚本，与我现有的 Go 微服务体系优雅地集成，而不是变成一坨无法维护的“耦合怪”？

这些问题，不是因为我们不懂 AI，而是因为我们太懂工程。我们厌倦了“炼丹”式的不确定性，我们渴望一种能将 AI 的强大能力，用严谨的工程纪律约束起来的解决方案。

现在，Google 亲自下场，为我们递来了“工程图纸”。

Google ADK for Go：写给工程师的 AI Agent 开发框架

这个霸榜的项目，全称是 Agent Development Kit (ADK) for Go。

这不是又一个“玩具”或“研究性”框架。从它的设计理念中，我看到了一个清晰而坚定的信号——AI Agent 开发，正在从“炼丹”式的“艺术创作”，全面进入“工程化”的“工业生产”时代。

而 ADK for Go 的核心哲学，与我们 Gopher 的信仰不谋而合，那就是——代码优先 (Code-First)。

你的 Agent，就是你的 Go 代码： 不再有晦涩的 YAML，不再有天书般的“链”，Agent 的所有逻辑、决策、工作流，都由你亲手编写的、地地道道的 Go 代码来定义。
天生的可测试性： 你的 Agent 就是一个实现了 agent.Agent 接口的 struct。这意味着什么？你可以像测试任何 Go 代码一样，go test 走起！Mock 依赖、断言行为，所有你熟悉的工程实践，全部回归。
Git 即版本管理： Agent 的每一次进化，都是一次清晰的 git commit。Code Review、版本回滚，一切都尽在掌握。
云原生无缝集成： 它就是一个标准的 Go 模块，可以被无缝地集成到你的 Gin/gRPC 服务中，打包成一个极小的 Docker 镜像，部署到任何 K8s 集群。

这就是为什么它能霸榜 GitHub 的原因——它不是在教你如何更好地“调优 Prompt”，而是在教你如何用坚实的工程代码，去彻底终结那个不可控的“炼丹”时代。

Google的adk-go，就是那座连接 Gopher 工程世界与 AI Agent 智能世界的桥梁。

和我一起，从零开始“造”一个真正的 AI Agent

坦白说，ADK for Go 刚刚推出，市面上的教程几乎一片空白。文档虽有，但如何将其与真实的工程场景结合，如何理解其设计背后的权衡，如何避开那些必将遇到的“坑”——这些都需要有人去探索，去趟路。

所以，我决定做这件事。

我将以一个“学伴”和“探索者”的身份，推出我的全新付费微专栏：

《Google ADK 实战：用 Go 构建可靠的AI Agent》

在这个专栏里，我不会扮演一个无所不知的专家。相反，我会将我从零开始学习、实践、踩坑、顿悟的全过程，毫无保留地分享给你。

我们将一起，手把手地、从一个空 main.go 文件开始，完成一次令人兴奋的创造之旅：

第 1-2 讲：思维转变与灵魂注入
我们将彻底理解“代码优先”的哲学，拆解adk-go，了解其中的概念、架构和核心组件，并亲手定义出第一个实现了 agent.Agent 核心接口的智能体。
第 3 讲：为 Agent 插上“手臂”： 让你的Agent能调用任何Go函数，像操作自己的手脚一样自如
我们将学会 ADK 的“魔法”函数 functiontool.New，将一个普通的 Go 函数，零成本地转化为 Agent 可用的工具。
第 4 讲：赋予 Agent “双核记忆”
我们将深入 session（短期记忆）和 memory（长期记忆），让我们的 Agent 能够理解上下文，并记起与你的历史交互。
第 5 讲：从“单兵”到“军团”： 构建一个懂分工、会协作的Agent团队，自动化完成复杂任务
我们将学习 workflowagents，通过编排多个专家 Agent，构建一个强大的“代码生成-审查-重构”自动化流水线。
第 6 讲：从“原型”到“产品”
我们将为 Agent 建立科学的评估体系，并最终将其打包成 Docker 镜像，部署到通用的 Kubernetes 环境中。

学完这个专栏，你将收获的，不仅是一个能跑起来的酷炫 AI 项目，更是一套可复用的、工程化的 AI Agent 构建方法论，以及在 AI 新浪潮中，属于我们 Gopher 的那份自信和底气。

加入这场 Gopher 的 AI 工程化之旅

这个微专栏，是我为你，也为我自己准备的一份“AI 时代 Gopher 生存指南”。它凝聚了我对 Go 工程哲学的理解，和我对 AI Agent 未来的全部热情。

微专栏共 6 篇深度长文，每一篇都是我亲手实践、细节满满的 step-by-step “航海日志”。

我没有设定一个高昂的价格，而是希望与更多志同道合的 Gopher 一起探索。所以，订阅这份专栏，仅需你一杯咖啡的诚意。

花一杯咖啡的时间，你或许能得到片刻的清醒；而用同样的价格投入到这里，我希望能为你带来一次思维的升级和技能的跃迁。

点击这里，或扫描二维码，立即加入。

让我们一起，用代码，构建智能。

P.S. 如果你对 AI Agent、Go 语言或者这个微专栏有任何问题，欢迎在评论区留言，我们一起交流探讨！

还在为“复制粘贴喂AI”而烦恼？我的新专栏 《AI原生开发工作流实战》 将带你：

告别低效，重塑开发范式
驾驭AI Agent(Claude Code)，实现工作流自动化
从“AI使用者”进化为规范驱动开发的“工作流指挥家”

扫描下方二维码，开启你的AI原生开发之旅。

商务合作方式：撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求，请扫描下方公众号二维码，与我私信联系。

本文永久链接 – https://tonybai.com/2025/11/17/go-testing-journey

大家好，我是Tony Bai。

我想请大家想象一个场景：

周五下午五点，你刚刚修复了一个看似无关紧要的 bug，怀着对周末的憧憬，合并了你的代码。CI/CD 流水线一片绿灯，部署顺利完成。

突然，运维在工作群里 @ 了你：“紧急！新版本上线后，核心的用户注册功能好像挂了！”

你心里猛地一沉，这个功能你根本没动过，只是修改了它依赖的一个底层工具函数。冷汗开始从额头渗出，你下意识地喃喃自语：“不可能啊，我的单元测试明明都通过了……”

这个场景，或许你我或多或少都经历过。它引出了一个直击所有工程师灵魂的问题：为什么我们辛辛苦苦写的测试，没能挡住这次线上事故？

你的测试，是否也只是“看起来很美”？

在深入探讨之前，不妨和我一起做个小小的“体检”，看看我们的测试代码是否也存在一些“亚健康”状态：

“晴天”的信徒： 你的测试是否只覆盖了“阳光普照”的成功路径，却选择性地忽略了数据库连接失败、Redis 缓存击穿、下游 API 超时等“电闪雷鸣”的异常场景？
脆弱的“模拟”大师： 你是否为了写测试而构建了庞大而脆弱的 Mock 王国？以至于每次重构核心逻辑，都意味着要重写一半的测试代码，让你对重构本身心生恐惧，技术债越积越多。
“发布”前的祈祷者： 当项目越来越大，你敢在没有一轮紧张的手动回归测试的情况下，自信地点击“发布”按钮吗？go test ./… 的漫长等待是否已经让你无法忍受？

如果以上问题让你感同身受，那说明我们的测试体系，可能还停留在“演员在镜子前练习自己台词”的阶段。它能保证你自己的“台词”（单个函数）没问题，却无法保证你在“舞台”上（真实环境）与其他“演员”（数据库、缓存、API）的配合不出错。

而线上事故，往往就出在这些“接缝”之处。

真正的信心，源自体系化的“测试之道”

那么，如何构建一个能真正守护我们安稳度过每个周末的测试体系呢？答案不在于写更多的单元测试，而在于建立一个科学、分层、覆盖从已知到未知的自动化测试系统。

这不仅仅是一门教你写测试的课程。这是一门为你注入“持续交付信心”的工程实践课。

我将以一个贯穿始终的“短链接”实战项目为例，带你走过一条完整的进阶之路——从构建坚实的“测试金字塔”，到掌握前沿的“高级实践”。

在这门专栏里，你将获得什么？

一套完整的 Go 测试“作战地图”: 我们将自底向上，系统性地构建单元测试、集成测试、契约测试和端到端测试，让你清晰地知道在何处写何种测试。
“驯服”外部依赖的终极武器: 我将手把手带你使用 Testcontainers，在测试代码中“一键”拉起真实的数据库和 Redis，彻底告别脆弱的 Mock 和不稳定的共享测试环境。
一个装满“黑魔法”的高级工具箱: 我们不会止步于基础。你还将学到：
- 如何用覆盖率 (Coverage) 分析工具为你的测试“查漏补缺”。
- 如何用模糊测试 (Fuzzing) 去探索人类思维难以触及的“未知”边界。
- 如何用黄金文件 (Golden Files) 优雅地解决对复杂输出的断言难题。
一种全新的“可靠性”思维: 我们将初步探索混沌工程 (Chaos Engineering)，学习如何在测试中有控制地注入网络延迟、中断等故障，将你的测试思维从“验证功能”提升到“考验韧性”。
最终目标： 让你拥有在任何时候都敢于自信重构、放心发布的工程能力。

专栏学习路径一览

为了让你对这次学习之旅有更清晰的预期，这里是我们将要共同探索的“新大陆地图”：

模块一：测试金字塔之基 (地基篇)
- 第 1-3 讲: 深入单元测试，掌握表驱动、Fake Object、httptest 等核心技巧，为 service 和 handler 层构建坚固的“零件”质量保证。
模块二：测试金字塔之腰 (集成篇)
- 第 4-6 讲: 掌握用构建约束隔离测试，并深入集成测试的核心。我们将用 Testcontainers 自动化编排 PostgreSQL 和 Redis，验证真实的服务间协作。
模块三：测试金字塔之顶 (验收篇)
- 第 7-8 讲: 探索微服务时代的契约测试，并最终站在用户视角，用 docker-compose 搭建完整环境，进行端到端 (E2E) 测试的“终极验收”。
模块四：高级实践与可靠性工程 (进阶篇)
- 第 9 讲 (高能预警!): Go 测试的“黑魔法”合集！一次性解锁覆盖率分析、Fuzzing 和 Golden Files 三大神器。
- 第 10 讲 (思想升华!): 拥抱“混乱”！学习混沌工程思想，并用 toxiproxy 在测试中主动注入网络故障，考验我们系统的韧性。