🏗️ 后端架构分层设计：用好 MVC，让你的项目不再一团乱麻！

开发一个后端项目，有没有遇到过这种情况：

文件越写越多，逻辑堆在一起像一锅粥 🤯

改个接口要跳好几个 if else，甚至动到数据库层 😰

没有模块划分，新人接手直接懵圈 ❓

别担心，今天我们来聊聊后端开发中最经典、最实用的“分层架构设计” —— 以 MVC 模型为基础，搭建一套职责清晰、结构合理的项目骨架，让你的代码能跑、能扩、能维护！💪

✨ 一、为什么要分层设计？

软件架构的本质是“解耦”！当你的业务逻辑变得复杂时，如果所有东西都写在一起，很快就会变成“无法维护的泥潭”。

分层设计的目标就是：

✅ 各司其职，职责清晰
✅ 易于维护，代码可扩展
✅ 提升协作效率，团队开发不卡壳
✅ 避免“耦合地狱”和“命名炼狱”

🧱 二、经典 MVC 架构 + 五大核心模块

MVC 是最常见的后端分层架构，它将程序拆分为三大核心组件：

组件	作用简述
Model	与数据库打交道，封装数据结构和业务实体
View	返回给前端的数据（REST 接口中表现为 JSON 响应）
Controller	接收请求，调度逻辑，调用 Model 并返回 View

我们可以在此基础上进一步扩展，形成更完整的模块划分：

1️⃣ `controllers/`：控制器层 🧠

负责接收请求、处理业务逻辑、返回响应。

拆分一个个具体业务控制器（如 userController、orderController）
做参数校验、业务判断、调用 Service/Model
尽量保持“瘦控制器”，不直接做复杂逻辑

// userController.js
exports.login = async (req, res) => {
  const { username, password } = req.body;
  const token = await authService.login(username, password);
  res.json({ code: 0, data: token });
};

2️⃣ `models/`：数据模型层 🗃️

负责与数据库交互，增删改查都在这里处理。

使用 ORM（如 Sequelize、Mongoose）或原生 SQL 封装
单一职责，只处理数据，不干涉业务逻辑

// userModel.js
const User = db.define('User', {
  username: DataTypes.STRING,
  password: DataTypes.STRING
});
module.exports = User;

3️⃣ `routes/`：路由注册 🛣️

负责统一配置 URL 与 controller 的绑定关系。

所有路由统一管理，便于查看和维护
可通过版本号或模块区分路由组

// routes/user.js
router.post('/login', userController.login);

4️⃣ `middlewares/`：中间件层 🛡️

负责请求拦截、身份校验、日志记录等“横向”逻辑。

常见中间件：JWT 鉴权、请求体校验、错误捕获、访问日志
独立编写，便于复用和测试

// middlewares/auth.js
module.exports = function (req, res, next) {
  const token = req.headers['authorization'];
  if (!verifyToken(token)) return res.status(401).json({ code: 401, message: '未授权' });
  next();
};

5️⃣ `utils/`：工具类 💡

封装通用函数，如响应格式化、时间转换、日志输出等。

可建多个工具文件：response.js、logger.js、crypto.js
注意通用性与可读性，避免工具逻辑侵入业务

// utils/response.js
exports.success = (data) => ({ code: 0, message: 'OK', data });
exports.error = (code, message) => ({ code, message });

⚙️ 三、典型项目目录结构参考

project-root/
│
├── controllers/      # 控制器
├── models/           # 数据模型
├── routes/           # 路由配置
├── middlewares/      # 中间件
├── utils/            # 工具函数
├── config/           # 配置文件（数据库、环境变量等）
├── app.js            # 应用入口
└── server.js         # 启动服务