关键在于请求是否真正到达断点所在路由，而非断点能否设置；常见原因包括入口文件路径错误、未启用--inspect、源码与运行文件不一致、中间件提前终止请求及端口冲突等。
VSCode 调试 Node.js 后端 API 接口，关键不是“能不能断点”，而是“请求能不能真正走到断点那行”——多数失败案例里，断点根本没被触发，不是配置错，是请求压根没进来。
为什么在 Express/Koa 路由里设了断点却从不停？
常见现象：F5 启动调试，控制台显示服务已监听 3000，但用 curl http://localhost:3000/api/users 或 Postman 发请求，断点完全不触发，控制台也无任何日志。
- 入口文件路径写错：
program指向的是${workspaceFolder}/index.js，但实际启动文件是src/server.js或bin/www，路径不匹配就等于没跑你的代码 - Node 进程没带
--inspect：VSCode 的type: "node"配置默认会加，但如果手动改过runtimeArgs却漏掉--inspect-brk，调试器就无法注入 - 源码和运行时文件不一致：TypeScript 项目直接调试
src/index.ts但没配ts-node或sourceMap，VSCode 实际绑定的是编译后的dist/index.js，而你在 TS 源码上打的断点自然失效 - Express 中间件提前终止了请求：比如
app.use(express.json())报错（body 太大、格式不对），后续路由根本不会执行——此时要先在中间件或错误处理函数里设断点查原因
launch.json 必须填对的三个字段
别套模板，每个字段都得对应你项目的实际运行逻辑。以下是最简但有效的配置骨架：
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug API Server",
"program": "${workspaceFolder}/src/server.js",
"env": {
"NODE_ENV": "development",
"PORT": "3001"
},
"console": "integratedTerminal",
"skipFiles": ["<node_internals>/**"]
}
]
}</node_internals>
-
program：必须是真实可执行的 JS 文件路径，不能是 TypeScript 源文件（除非配了ts-node）；若用npm start启动，改用runtimeExecutable: "npm"+args: ["start"] -
env.PORT：强制换端口，避免和已运行的服务冲突；尤其当你本地常驻一个npm run dev进程时，调试必须错开端口 -
skipFiles：删掉"${workspaceFolder}/node_modules/**/*.js"这类宽泛路径，否则可能跳过你依赖里的关键调试点（比如某些 ORM 的 query 方法）
如何确认请求真的进了断点所在的路由？
别靠猜，用两行代码快速验证执行流是否抵达目标位置：
- 在路由 handler 开头加一句
console.log('✅ route hit:', req.url)，启动调试后看终端输出是否出现——没输出说明请求根本没路由到这，检查app.use()顺序、路径前缀（如/api）、HTTP 方法（GETvsPOST） - 把断点设在
app.use((req, res, next) => { ... })全局中间件里，看是否能捕获所有请求；如果这里都不停，问题一定出在服务未真正启动或端口监听失败 - 用
curl -v http://localhost:3001/api/users看响应头状态码，404就别调接口逻辑了，先查路由注册是否生效
调试异步 API 时最易忽略的三件事
Promise、async/await、数据库查询这些操作会让断点“看似失效”，其实只是暂停时机不对。
- 不要在
.then()回调内部设断点：V8 引擎可能优化掉该回调帧，导致断点跳过；改用async/await写法，并在await行或函数顶部设断点 - 数据库查询（如 Prisma、Mongoose）返回的是 Promise，断点设在
const user = await db.user.findFirst(...)下一行，才能看到结果；设在await行本身只停在等待态，变量还是undefined - 调试中修改变量值（比如在 Debug Console 输入
req.body.id = 999）只影响当前作用域，不会改变原始请求数据——想测不同参数，得重发请求，别指望改完变量就自动重走逻辑
真正卡住人的从来不是“怎么加断点”，而是“为什么请求没进断点”。每次断点不触发，先确认 program 路径对不对、PORT 冲不冲突、console.log 有没有输出——比反复检查 launch.json 有效得多。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
