Node.js应用如何优雅分离Service与Router层实现用户创建逻辑

要实现service层和router层的清晰解耦，核心原则是service层只处理纯业务逻辑，完全不感知HTTP层的req、res对象，router层仅负责请求参数接收、响应构造、路由映射，两者互不依赖。

你最初的实现将req、res直接传入service，会导致service和HTTP层强绑定，无法在非HTTP场景（比如定时任务、内部服务调用）复用；你自己修改的版本虽然完成了基础分离，但把数据赋值、数据库保存的逻辑放在了路由层，还是不符合职责划分的要求。

callback版本实现 #

UserService.js

const User = require('./models/User') // 替换为你自己的User模型引入路径

// 入参仅接收用户原始数据、callback回调函数
// 回调遵循Node.js惯例：第一个参数为错误对象，第二个为返回结果
function createUser(userData, callback) {
  const user = new User({
    userID: userData.userID,
    userName: userData.userName,
    password: userData.password,
    isAdministrator: userData.isAdministrator
  })
  // 数据库操作完全放在service层处理
  user.save((err, savedUser) => {
    if (err) return callback(err)
    callback(null, savedUser)
  })
}

module.exports = { createUser }

UserRouter.js

const userService = require('./UserService')

router.post('/publicUser', function(req, res, next) {
  // 路由层仅提取请求参数、处理响应和错误
  const userParams = {
    userID: req.body.userID,
    userName: req.body.userName,
    password: req.body.password,
    isAdministrator: req.body.isAdministrator
  }
  userService.createUser(userParams, (err, savedUser) => {
    if (err) {
      console.log(err)
      return res.status(500).json({ msg: '用户创建失败' })
    }
    res.json(savedUser)
  })
})

更推荐的现代写法（async/await） #

目前Node.js生态已经普遍用async/await替代callback，避免回调嵌套问题，写法更简洁易维护：

UserService.js

const User = require('./models/User')

async function createUser(userData) {
  const user = new User(userData)
  // 可在此处扩展业务逻辑，比如密码加密、参数合法性校验等
  return await user.save()
}

module.exports = { createUser }

UserRouter.js

const userService = require('./UserService')

router.post('/publicUser', async function(req, res, next) {
  try {
    // 可在此处扩展请求参数校验逻辑，比如判断必填字段是否为空
    const savedUser = await userService.createUser(req.body)
    res.json(savedUser)
  } catch (err) {
    console.log(err)
    res.status(500).json({ msg: '用户创建失败' })
  }
})

上述实现的优势 #

• service层完全独立，任何场景只要传入符合格式的用户数据就可以调用创建逻辑，复用性极强
• 两层职责完全拆分，后续修改创建用户的业务逻辑时只需要改service代码，修改响应格式、错误码时只需要改路由代码，维护成本低
• 便于单元测试，测试service时不需要构造HTTP请求对象，直接传参数即可

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