qoder生成node.js接口后需立即验证可调用性、返回结构与错误路径：先执行qoder dev启动服务并确认端口监听，再用curl或postman测试路由连通性，最后通过qoder test运行单元测试并结合--coverage检查逻辑分支覆盖率。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder生成Node.js接口代码后，需立即验证接口是否可调用、返回结构是否符合预期、错误路径是否被覆盖，不能只依赖生成时的模拟响应。
启动服务并确认端口监听
进入项目根目录，执行qoder dev启动开发服务器。该命令会自动检测src/backend下的Express或Fastify入口文件，并绑定默认端口（通常为5000）。
若终端未输出类似✅ Server running on http://localhost:5000的提示，则说明服务未真正启动——常见原因是package.json中缺失"scripts": {"dev": "qoder dev"}字段，需手动补全后再运行。
打开新终端窗口，执行curl -I http://localhost:5000/health。收到HTTP/1.1 200 OK即表示基础服务已就绪；若返回Failed to connect，请检查是否仍有其他进程占用了5000端口。
用Postman快速发起真实请求
方法一：导入Qoder自动生成的Postman集合
Qoder在生成Node.js后端代码时，会同步生成postman-collection.json文件，位于__generated__/postman目录下。直接在Postman中点击「Import」→「Upload Files」，选择该文件即可加载全部接口请求模板。
方法二：手动构造GET请求验证路由连通性
以生成的用户列表接口为例，在Postman中新建请求，URL填http://localhost:5000/api/users，发送后应返回JSON数组；若返回Cannot GET /api/users，说明Qoder生成的路由未被Express正确use，需检查src/backend/app.ts中是否漏掉了app.use('/api', userRouter)这一行。
【注意：Postman必须使用原始URL，不能带query参数再点“Send”后手动修改地址栏——这会导致缓存旧响应】
编写并运行单元测试验证逻辑分支
第一步：确认测试环境已初始化
执行qoder init --test。该命令会创建__tests__目录、生成jest.config.js，并安装@qoder/test-utils。若跳过此步，后续qoder test将报错Cannot find module 'jest'。
第二步：编写一个最小可用测试文件
在__tests__/api/users.test.ts中写入：
import request from 'supertest';<br>import { app } from '../../src/backend/app';<br><br>describe('GET /api/users', () => {<br> it('should return 200 and array', async () => {<br> const res = await request(app).get('/api/users');<br> expect(res.status).toBe(200);<br> expect(Array.isArray(res.body)).toBe(true);<br> });<br>});
第三步：运行该测试
执行qoder test __tests__/api/users.test.ts。成功时终端显示✓ GET /api/users › should return 200 and array；失败时会明确指出是status不匹配还是body类型错误，而非笼统的“测试崩溃”。
第四步：触发覆盖率报告
追加--coverage参数：qoder test __tests__/api/users.test.ts --coverage。生成的coverage/lcov-report/index.html中，红色高亮区域即为未被执行的代码行——比如JWT中间件里if (!token)分支未覆盖，就必须补上携带空Authorization头的测试用例。
