地牢调试

你站在一个黑暗的函数中。出口通向三个catch块和一个回调。地上躺着一个名为temp2的变量。它是undefined的。掷先攻骰子。

功能说明

调试本身就是一场冒险——只是你没有地图、血条或戏剧性的旁白。地牢调试改变了这一切。

每一次调试会话都变成了一场基于文本的RPG地牢探险，其中：

• - Bug是隐藏在地牢某处的最终Boss
• 栈帧是你探索的房间
• 变量是你检查并收集的物品
• 日志消息是地牢墙壁上的铭文
• 断点是存档点
• 你的假设是你选择的路径
• 死胡同是让你学到教训的陷阱

听起来很荒谬。它确实很荒谬。但它也有效——因为RPG格式强制系统化探索，防止你跳过房间（栈帧），并且让调试过程变得足够有趣，让你不会在45分钟后愤怒退出。

地牢地图

你的Bug报告生成一个地牢：

╔══════════════════════════════════════════════════════════════╗
║ BUG #4721 的地牢 ║
║ 幻影空值：一个类型错误之谜 ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 地牢地图（由堆栈跟踪生成）： ║
║ ║
║ [入口] ──→ [UserController.handleRequest] ║
║ │ ║
║ ▼ ║
║ [AuthService.validateToken] ║
║ │ ║
║ ▼ ║
║ [UserRepository.findById] ◀── 宝箱：SQL查询 ║
║ │ ║
║ ▼ ║
║ [ProfileMapper.toDTO] ← ☠ Boss房间 ☠ ║
║ │ ║
║ ▼ ║
║ 💀 TypeError: 无法读取 undefined 的 email ║
║ ║
║ 房间数：4 | 难度：★★★☆☆ | 预计时间：15-30分钟 ║
╚══════════════════════════════════════════════════════════════╝

角色职业

选择你的调试风格：

╔══════════════════════════════════════════╗
║ 选择你的职业，冒险者： ║
║ ║
║ [1] 📜 日志者 (记录一切) ║
║ [2] 🔴 断点者 (断点) ║
║ [3] 📖 阅读者 (先阅读) ║
║ [4] ⏪ 逆向者 (错误优先) ║
║ [5] 🔬 科学家 (假设驱动) ║
╚══════════════════════════════════════════╝

房间探索

每个栈帧都是一个待探索的房间：

╔══════════════════════════════════════════════════════════════╗
║ 房间 3/4：UserRepository.findById() ║
║ src/repositories/user-repository.ts:47 ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 📜 墙上的铭文（附近日志）： ║
║ 正在获取用户，id为：undefined ║
║ 嗯。这看起来不对劲。 ║
║ ║
║ 🎒 本房间物品（局部变量）： ║
║ ├── userId: undefined ← ⚠️ 可疑物品 ║
║ ├── query: SELECT * FROM users WHERE id = $1 ║
║ └── result: null（查询未返回任何结果） ║
║ ║
║ 🚪 出口： ║
║ ├── 返回：AuthService.validateToken（userId的来源） ║
║ ├── 前进：ProfileMapper.toDTO（Boss房间） ║
║ └── 检查：更仔细查看userId的来源 ║
║ ║
║ 💡 冒险者笔记： ║
║ userId是undefined。查询以undefined作为参数运行。 ║
║ 数据库返回了null。这个null被传递给了ProfileMapper， ║
║ 它试图在null上读取.email。 ║
║ ║
║ Boss（TypeError）住在房间4，但根本原因可能在房间2 ║
║ （设置userId的地方）甚至房间1。 ║
║ ║
║ 你做什么？ ║
║ [1] 🚪 返回房间2（追踪userId的设置位置） ║
║ [2] 🚪 前往Boss房间（面对TypeError） ║
║ [3] 🔍 检查：谁调用了findById，用了什么参数？ ║
║ [4] 📜 阅读完整函数源码 ║
╚══════════════════════════════════════════════════════════════╝

Boss战

当你追踪到Bug的源头时：

╔══════════════════════════════════════════════════════════════╗
║ ☠ Boss战 ☠ ║
║ 幻影空值已被逼入绝境！ ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 已识别根本原因： ║
║ AuthService.validateToken()返回的是令牌载荷， ║
║ 而不是用户对象。令牌载荷有sub（主题ID）， ║
║ 而不是userId。控制器解构了{ userId }， ║
║ 结果是undefined。 ║
║ ║
║ 致命一击： ║
║ ├── 文件：src/controllers/user-controller.ts:12 ║
║ ├── Bug：const { userId } = await auth.validateToken(token) ║
║ ├── 修复：const { sub: userId } = await auth.validateToken()║
║ └── 或：const { userId } = await auth.getUser(token) ║
║ ║
║ 选择你的武器： ║
║ [1] ⚔️ 快速修复：将sub解构为userId ║
║ [2] 🛡️ 正确修复：添加返回完整用户的getUser() ║
║ [3] 🔮 防御性修复：在findById()中添加空值检查 ║
║ ║
╚══════════════════════════════════════════════════════════════╝

胜利画面

╔══════════════════════════════════════════════════════════════╗
║ ║
║ ⚔️ 胜利！Bug已被斩杀！ ⚔️ ║
║ ║
║ Bug：幻影空值（ProfileMapper中的TypeError） ║
║ 根本原因：UserController中错误的解构键