Node.js Express如何从Service层向Controller返回带状态码响应

核心原则 #

服务层不要直接操作res响应对象——HTTP状态码设置、响应返回是控制器的职责，服务层只需要处理纯业务逻辑，通过返回值传递成功结果、抛出带状态码的错误对象传递失败场景即可，两层完全解耦。

具体代码修改 #

1. 重写服务层（registerservice.js） #

移除所有对res的直接调用，业务异常直接抛出，成功时返回处理完成的业务数据，同时修复原代码未声明变量的隐性bug：

const { User } = require('../models/user');

async function register(params) {
    // 先校验邮箱是否已存在
    const existUser = await User.findOne({ email: params.email }).exec();
    if (existUser) {
        const duplicateErr = new Error('Duplicate Email');
        duplicateErr.statusCode = 400;
        throw duplicateErr;
    }

    // 构建用户实例
    const user = new User({
        name: params.name,
        email: params.email,
        passwordHash: params.password,
        phone: params.phone,
        isAdmin: params.isAdmin,
        street: params.street,
        apartment: params.apartment,
        zip: params.zip,
        city: params.city,
        country: params.country,
    });

    // 持久化存储
    const savedUser = await user.save();
    if (!savedUser) {
        const createErr = new Error('the user cannot be created!');
        createErr.statusCode = 400;
        throw createErr;
    }

    // 正常返回保存后的用户数据
    return savedUser;
}

module.exports = {
    register
};

2. 重写控制器层（controller.js） #

控制器统一接收服务层结果、捕获异常，负责设置HTTP状态码、返回响应：

router.post("/register", async (req, res, next) => {
    try {
        const createdUser = await registerServices.register(req.body);
        // 创建资源成功返回201状态码，符合RESTful规范
        return res.status(201).send(createdUser);
    } catch (err) {
        // 优先使用错误自带的业务状态码，未定义则默认返回500服务端错误
        const status = err.statusCode || 500;
        return res.status(status).send(err.message);
        // 如果项目配置了全局错误处理中间件，也可以直接把错误交给中间件：next(err)
    }
});

方案优势 #

• 职责完全解耦：服务层不依赖HTTP层的请求/响应对象，后续如果需要复用注册逻辑（比如后台管理端手动创建用户、定时任务批量导入用户），可以直接调用服务方法，不需要做任何适配
• 错误处理统一：所有业务错误、数据库运行错误都会被控制器的catch块捕获，不需要在每个业务分支重复写响应逻辑，后续要统一错误响应格式（比如改成{code:400, msg:"xxx", data:null}的结构）只需要改控制器一处即可
• 规避原代码问题：修复了原代码中checkUser未声明导致的全局变量污染问题，彻底解决服务层拿不到res对象导致的运行时报错

内容的提问来源于stack exchange，提问作者rameez khan