Node.js+Koa2+MySQL 打造前后端分离精品项目《旧岛》【15章完整】

《旧岛》这个项目名字听起来像是文艺向的小站，但它实际是一套前后端分离的完整后端实现，技术选型是 Node.js + Koa2 + MySQL。课程一共 15 章，从目录结构看，它不是那种「先讲 20 集语法再动手」的类型，而是把异常处理、分组查询、JWT 权限这些真实项目里绕不开的点拆成独立章节来讲。这类资料适合拿来做对照实践：你先按自己的思路搭一遍，卡住了再回来看它怎么处理。

技术栈与项目定位

后端用 Koa2 而不是 Express，这一点值得注意。Koa2 的中间件是洋葱模型，async/await 写起来更顺，但生态里现成的轮子比 Express 少，很多事得自己写中间件。课程里专门有章节讲全局异常处理中间件的编写，这就是 Koa2 项目里必须自己动手的部分——Express 有现成的 errorhandler，Koa2 通常要按自己的返回格式定制。

数据库选 MySQL，配合 Koa2 做接口层。前端没有绑死框架，前后端分离的关键在于接口约定和鉴权方式，而不是前端用 Vue 还是 React。所以这套资料的重心在后端：路由怎么组织、参数怎么校验、异常怎么统一返回、权限怎么控。

异常处理这条线值得单独看

第 4 章把「异步异常」和「全局异常」放在一起讲，这是 Koa2 项目里最容易写乱的地方。异步中间件里 throw 出去的错，如果不接住，进程可能直接挂掉，或者返回一个前端无法解析的堆栈。课程里会讲到全局异常处理中间件的编写、异常返回格式的定义、以及特定异常类的划分。

这部分的可复用性很高：定义一个业务异常基类，按错误类型派生出参数异常、权限异常、资源不存在异常，再由全局中间件统一转成固定结构的 JSON 返回。前端拿到{ code, message, data }这套约定后，就不用每个接口单独判断 HTTP 状态码和错误文案。你做自己的项目时，这套结构可以直接搬。

MySQL 分组查询与数据层组织

课程里把 MySQL 分组查询单独拎出来讲，说明《旧岛》的数据模型不是简单的单表增删改查。分组查询通常出现在统计、聚合、按维度汇总的场景，比如按分类统计内容数量、按时间聚合数据。写这类查询要理解 GROUP BY 和聚合函数的配合，还要注意 SELECT 字段和分组字段的对应关系。

数据层一般不会把 SQL 散落在路由里，而是抽成 model 或 service。看这部分时重点留意它怎么组织查询函数、怎么处理参数拼接、有没有做基本的防注入。Koa2 生态里没有强制的 ORM，用原生 SQL 还是上 Knex 之类的查询构造器，课程的选择会直接影响你后续的复用方式。

JWT 权限控制与前后端分离的衔接

前后端分离后，登录态不再靠 session 和 cookie 维持，JWT 是常见方案。课程里的 JWT 权限控制会涉及 token 的签发、校验中间件、以及受保护路由的拦截。关键点是中间件的位置：鉴权中间件要放在业务路由之前，校验通过后把用户信息挂到 ctx 上，后面接口直接取用。

这里也有几个工程上的坑值得对照：token 过期怎么处理、刷新机制有没有、白名单路由（登录、注册）怎么放行。这些细节决定了这套鉴权方案能不能直接用到你自己的项目里。

怎么用这份资料

• 先按自己的习惯搭一个 Koa2 骨架，路由、中间件、数据库连接各就各位，跑通一个最简单的接口，再对照课程看结构差异。
• 异常处理那一章建议精读并动手改：先写一个会抛错的异步接口，观察默认行为，再逐步加上自定义异常类和全局中间件。
• MySQL 部分重点看分组查询和关联查询的写法，把 SQL 单独拎到控制台跑一遍，确认结果集结构再对应到接口返回。
• JWT 部分注意中间件的挂载顺序和 token 校验失败时的返回，这两点直接影响前端联调体验。
• 15 章的内容不必线性看完，按「数据层—异常—鉴权—业务接口」的顺序对照自己的代码查漏补缺效率更高。

这套资料的定位是工程参考而不是入门教程。如果 Koa2 的中间件机制、async/await 的错误传播、MySQL 的基本查询你都还没写过，直接跟做会比较吃力；反过来，如果你已经能写出接口但项目结构散、异常处理乱、权限控制靠硬编码，那第 4 章和 JWT 部分正好能补上结构化的那一环。