如何在Node.js的Koa框架中正确发送响应？代码无返回问题排查

你这段代码没有返回内容的原因是，Koa中仅设置ctx.status和ctx.message并不一定会自动向客户端返回预期的响应体——ctx.message通常只是状态码对应的默认描述文本，不会作为自定义业务响应发送。要让客户端收到明确的内容，需要主动设置响应体。

修复后的代码示例 #

let user = await User.findOne({ mobile: ctx.request.body.mobile });
if (user) {
    ctx.status = 400;
    // 设置JSON格式的响应体，返回自定义错误信息
    ctx.body = {
        message: "Already Exist"
    };
} else {
    let userData = await new User(ctx.request.body).save();
    ctx.status = 200;
    // 返回成功信息及可选的用户数据
    ctx.body = {
        message: "User Registered Success",
        data: userData
    };
}

关键说明 #

• ctx.body是核心：Koa通过ctx.body设置响应体内容，支持字符串、JSON对象、Buffer等格式。仅设置status和message时，客户端可能收到空响应或系统默认的状态描述，无法获取你定义的业务消息。
• 状态码与响应体配合：先用ctx.status指定HTTP状态码，再通过ctx.body返回业务相关的消息或数据，确保客户端能明确接收你期望的响应内容。
• 简化错误响应写法：如果不需要自定义响应结构，也可以用ctx.throw(400, "Already Exist")快速抛出错误响应，但这种方式会返回Koa默认的错误格式，自定义场景下建议手动设置ctx.status和ctx.body。

内容的提问来源于stack exchange，提问作者Akshay Udapure