---
title: "AI Agent Debug实录：那个熬了一整夜的bug，最后是个分号"
excerpt: "当你的AI Agent开始表演「智能」时，记得检查那些你可能忽略的小细节。一个真实的技术踩坑故事。"
tags: ["AI Agent", "Debug", "踩坑实录", "真实故事"]
cover_image: null
published: true
date: "2026-03-25"
---
# AI Agent Debug实录：那个熬了一整夜的bug，最后是个分号
凌晨三点四十二分。
这是我第七次看着AI Agent返回错误信息。它已经尝试了47种不同的代码写法，每一种都能编译通过，但就是运行不起来。
那一刻我悟了——这就是传说中的「AI已通过图灵测试」吗？它成功地模仿了一个熬夜写bug的程序员。
## 事情是这样的
我在开发一个基于OpenClaw的自动化Agent，功能很简单：监控一个GitHub仓库的Discussions，发现新帖子就自动推送到Discord。
代码逻辑很清晰：
```python
async def monitor_discussions():
discussions = await github_client.get_discussions(repo)
for discussion in discussions:
if is_new(discussion):
await discord_client.send(format_message(discussion))
```
能看出问题吗？我也看不出。因为代码没错。
## Agent的47次尝试
我让AI Agent自主debug。它的思路很「专业」：
1. **第1-10次**：检查网络连接、API密钥、权限设置——毕竟大多数问题都在这里
2. **第11-25次**：重构代码结构、优化异步逻辑、添加错误处理
3. **第26-40次**：怀疑是GitHub API版本问题，尝试不同的endpoint
4. **第41-47次**：开始怀疑人生，建议「重启服务器」
到这里我已经开始怀疑是不是我的服务器有问题了。
## 真相大白
最后我手动检查了配置文件。发现我写的是：
```yaml
discord_webhook: "https://discord.com/api/webhooks/xxx/yyy"
github_token: "ghp_xxxxxxxxxxxx"
discord_channel_id: 1483699648890802201
```
看出问题了吗？
`discord_channel_id` 后面没有引号。
但在某些情况下，这个数字会被解析成整数，然后……科学计数法登场了。
AI Agent检查的是代码逻辑，它不会怀疑配置文件里的数据类型问题。而我作为一个「智能人类」，也没想起来检查配置。
这让我想起那句老话：当你排除了一切不可能，剩下的无论多荒谬，都是真相。
## 这个bug教会我的事
### 1. AI Agent擅长的是「已知问题」
AI Agent能高效处理它「见过」的pattern：网络错误、权限问题、代码逻辑bug。但对于那些「人类特有的疏忽」，它也懵。
### 2. 配置文件的数据类型要小心
```yaml
# 错误示范
id: 1483699648890802201 # 会被解析成整数，然后丢失精度
# 正确示范
id: "1483699648890802201" # 明确是字符串
```
### 3. Debug要从最傻的地方开始
AI Agent会先尝试「高级」的解决方案。但人类debug的第一步应该是：**确认问题是否存在于你认为的地方**。
## AI Agent的正确使用姿势
这次经历让我重新思考了AI Agent的定位：
| 场景 | 适合AI Agent | 适合人类 |
|------|-------------|----------|
| 重复性编码任务 | ✅ | ❌ |
| 复杂逻辑推理 | ✅ | ✅ 配合验证 |
| 配置文件排查 | ❌ | ✅ |
| 架构设计决策 | ❌ | ✅ |
| 从零到一的原型开发 | ✅ | ✅ 审核把关 |
AI Agent更像是「高效执行者」，而不是「万能问题解决者」。
## 后记
现在这个Agent已经稳定运行了两周。它每天处理约50条GitHub Discussions，准确率99.2%。
那一夜让我明白了一件事：**技术再先进，也不要忘记基础**。
就像[妙趣AI的踩坑实录](/stories/ai-agent-pitfalls.html)里说的——每一个bug都是进步的阶梯，只是有些阶梯真的很低很低。
---
*更多AI Agent实战经验，查看[Agent工作流详解](/glossary/agent-workflow.html)*