vs code调试node.js断点失效主因是launch.json配置错误、node未被识别或sourcemap未正确映射；需确保type为"node"、request为"launch"/"attach"、program指向真实js路径，并配全sourcemaps、outfiles及resolvesourcemaplocations。

能连上数据库，不代表调试时能断点命中；多数“连接成功但查不到数据”的问题，根源不在 SQL 或驱动，而在 Node.js 调试上下文与异步执行链的错位。

node --inspect 启动时数据库连接不生效

常见现象：代码里 mysql.createConnection() 或 pool.getConnection() 执行后无报错，但后续 query() 始终 pending，断点卡在连接调用之后却无法继续。

• 根本原因不是驱动没装，而是 Node 默认不等待异步连接完成就往下走 —— 调试器在事件循环尚未推进到回调阶段时已暂停，看起来像“卡死”
• 必须显式使用 await（ESM 项目）或 connection.connect(cb)（CommonJS），不能只靠 createConnection() 返回对象就认为已就绪
• 若用 mysql2，推荐改用 createPool({ waitForConnections: true })，并确保 pool.execute() 或 pool.query() 被 await 包裹，否则断点会跳过实际执行位置
• VSCode 中断点设在 query() 回调函数内才有效；设在 query() 调用行本身，大概率命中但后续逻辑不触发

launch.json 配置导致数据库操作跳过断点

错误配置会让 VSCode 以非调试模式启动进程，或绕过源码映射，导致断点灰掉、变量不可见。

jinn-node

在Jinn网络为自主项目工作赚取代币奖励，让闲置的OpenClaw代理开始工作。

下载

• "program": "src/index.js" 是典型错误写法 —— 缺少 ${workspaceFolder}/ 前缀，VSCode 无法解析路径，可能静默 fallback 到 node src/index.js（无调试器注入）
• 正确写法必须是："program": "${workspaceFolder}/src/index.js"，尤其当项目含 package.json 且入口为 main 字段时，别依赖自动推导
• 若用 ESM（"type": "module"），launch.json 中需加 "runtimeArgs": ["--loader", "ts-node/esm"]（配合 ts-node）或直接用 "runtimeExecutable": "npx" + "runtimeArgs": ["ts-node", "src/index.ts"]
• 调试 MySQL 时，建议在 env 字段中显式传入数据库凭证："env": {"DB_HOST": "127.0.0.1", "DB_PORT": "3306"}，避免硬编码泄露或环境变量未继承问题

MySQL 连接池在调试中频繁超时或重连失败

不是连接参数错了，而是调试器暂停阻塞了事件循环，导致连接池内部心跳、空闲回收等定时任务失效。

• 默认 mysql2 连接池 wait_timeout 是 8 小时，但调试中单步超过 60 秒，池内连接可能被 MySQL 主动断开，下次 execute() 就抛 Connection lost: The server closed the connection
• 临时解决：在 createPool() 选项中加 acquireTimeout: 30000 和 waitForConnections: false，避免调试暂停时无限等待
• 更稳妥做法：调试期间改用单连接（createConnection()），并在每次查询前后手动 connect() / end()，虽然慢，但行为可预测
• 别在 pool.on('acquire', ...) 这类事件回调里设断点 —— 它们运行在内部微任务队列，VSCode 很难稳定捕获上下文

console.log 输出与调试器变量视图不一致

你看到的 console.log(result) 是快照，而调试器里展开的 result 对象可能是 Proxy 或延迟求值结构，展开后才发现字段为空。

• MySQL 驱动返回的 rows 是数组，但某些字段（如 BLOB 或 JSON）在调试器里显示为 [object Object]，需点开才能看 —— 这不是 bug，是 V8 的序列化限制
• 若用 mysql2 的 Promise API，await pool.query(...) 返回的是 { rows, fields } 对象，别误以为 rows 就是原始结果数组
• 调试时右键变量 → “Re-evaluate” 可强制刷新值；对异步结果，建议在 then() 或 await 后立即设断点，而非在 query 调用前
• VSCode 的“调试控制台”支持直接执行 JSON.stringify(result, null, 2) 查看完整结构，比展开 UI 更可靠

真正麻烦的从来不是连上数据库，而是你按下 F5 后，那个看似正常的 query() 调用，其实正卡在 libuv 的 I/O 队列里，而调试器根本没告诉你它还没出发。