Koa 框架教程

日期： 2017年8月 9日

Node 主要用在开发 Web 应用。这决定了使用 Node，往往离不开 Web 应用框架。

Koa 就是一种简单好用的 Web 框架。它的特点是优雅、简洁、表达力强、自由度高。本身代码只有1000多行，所有功能都通过插件实现，很符合 Unix 哲学。

本文从零开始，循序渐进，教会你如何使用 Koa 写出自己的 Web 应用。每一步都有简洁易懂的示例，希望让大家一看就懂。

零、准备

首先，检查 Node 版本。



$ node -v

v8.0.0

Koa 必须使用 7.6 以上的版本。如果你的版本低于这个要求，就要先升级 Node。

然后，克隆本文的配套示例库。（如果不方便使用 Git，也可以下载 zip 文件解压。）



$ git clone https://github.com/ruanyf/koa-demos.git

接着，进入示例库，安装依赖。



$ cd koa-demos

$ npm install

所有示例源码，都在 demos 目录下面。

一、基本用法

1.1 架设 HTTP 服务

只要三行代码，就可以用 Koa 架设一个 HTTP 服务。



// demos/01.js

const Koa = require('koa');

const app = new Koa();

app.listen(3000);

运行这个脚本。



$ node demos/01.js

打开浏览器，访问 http://127.0.0.1:3000 。你会看到页面显示"Not Found"，表示没有发现任何内容。这是因为我们并没有告诉 Koa 应该显示什么内容。

1.2 Context 对象

Koa 提供一个 Context 对象，表示一次对话的上下文（包括 HTTP 请求和 HTTP 回复）。通过加工这个对象，就可以控制返回给用户的内容。

Context.response.body属性就是发送给用户的内容。请看下面的例子（完整的代码看这里）。



// demos/02.js

const Koa = require('koa');

const app = new Koa();

const main = ctx => {

  ctx.response.body = 'Hello World';

};

app.use(main);

app.listen(3000);

上面代码中，main函数用来设置ctx.response.body。然后，使用app.use方法加载main函数。

你可能已经猜到了，ctx.response代表 HTTP Response。同样地，ctx.request代表 HTTP Request。

运行这个 demo。



$ node demos/02.js

访问 http://127.0.0.1:3000 ，现在就可以看到"Hello World"了。

1.3 HTTP Response 的类型

Koa 默认的返回类型是text/plain，如果想返回其他类型的内容，可以先用ctx.request.accepts判断一下，客户端希望接受什么数据（根据 HTTP Request 的Accept字段），然后使用ctx.response.type指定返回类型。请看下面的例子（完整代码看这里）。



// demos/03.js

const main = ctx => {

  if (ctx.request.accepts('xml')) {

    ctx.response.type = 'xml';

    ctx.response.body = '<data>Hello World</data>';

  } else if (ctx.request.accepts('json')) {

    ctx.response.type = 'json';

    ctx.response.body = { data: 'Hello World' };

  } else if (ctx.request.accepts('html')) {

    ctx.response.type = 'html';

    ctx.response.body = '<p>Hello World</p>';

  } else {

    ctx.response.type = 'text';

    ctx.response.body = 'Hello World';

  }

};

运行这个 demo。



$ node demos/03.js

访问 http://127.0.0.1:3000 ，现在看到的就是一个 XML 文档了。

1.4 网页模板

实际开发中，返回给用户的网页往往都写成模板文件。我们可以让 Koa 先读取模板文件，然后将这个模板返回给用户。请看下面的例子（完整代码看这里）。



// demos/04.js

const fs = require('fs');

const main = ctx => {

  ctx.response.type = 'html';

  ctx.response.body = fs.createReadStream('./demos/template.html');

};

运行这个 Demo。



$ node demos/04.js

访问 http://127.0.0.1:3000 ，看到的就是模板文件的内容了。

二、路由

2.1 原生路由

网站一般都有多个页面。通过ctx.request.path可以获取用户请求的路径，由此实现简单的路由。请看下面的例子（完整代码看这里）。



// demos/05.js

const main = ctx => {

  if (ctx.request.path !== '/') {

    ctx.response.type = 'html';

    ctx.response.body = '<a href="/">Index Page</a>';

  } else {

    ctx.response.body = 'Hello World';

  }

};

运行这个 demo。



$ node demos/05.js

访问 http://127.0.0.1:3000/about ，可以看到一个链接，点击后就跳到首页。

2.2 koa-route 模块

原生路由用起来不太方便，我们可以使用封装好的koa-route模块。请看下面的例子（完整代码看这里）。



// demos/06.js

const route = require('koa-route');

const about = ctx => {

  ctx.response.type = 'html';

  ctx.response.body = '<a href="/">Index Page</a>';

};

const main = ctx => {

  ctx.response.body = 'Hello World';

};

app.use(route.get('/', main));

app.use(route.get('/about', about));

上面代码中，根路径/的处理函数是main，/about路径的处理函数是about。

运行这个 demo。



$ node demos/06.js

访问 http://127.0.0.1:3000/about ，效果与上一个例子完全相同。

2.3 静态资源

如果网站提供静态资源（图片、字体、样式表、脚本......），为它们一个个写路由就很麻烦，也没必要。koa-static模块封装了这部分的请求。请看下面的例子（完整代码看这里）。



// demos/12.js

const path = require('path');

const serve = require('koa-static');

const main = serve(path.join(__dirname));

app.use(main);

运行这个 Demo。



$ node demos/12.js

访问 http://127.0.0.1:3000/12.js，在浏览器里就可以看到这个脚本的内容。

2.4 重定向

有些场合，服务器需要重定向（redirect）访问请求。比如，用户登陆以后，将他重定向到登陆前的页面。ctx.response.redirect()方法可以发出一个302跳转，将用户导向另一个路由。请看下面的例子（完整代码看这里）。



// demos/13.js

const redirect = ctx => {

  ctx.response.redirect('/');

  ctx.response.body = '<a href="/">Index Page</a>';

};

app.use(route.get('/redirect', redirect));

运行这个 demo。



$ node demos/13.js

访问 http://127.0.0.1:3000/redirect ，浏览器会将用户导向根路由。

三、中间件

3.1 Logger 功能

Koa 的最大特色，也是最重要的一个设计，就是中间件（middleware）。为了理解中间件，我们先看一下 Logger （打印日志）功能的实现。

最简单的写法就是在main函数里面增加一行（完整代码看这里）。



// demos/07.js

const main = ctx => {

  console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);

  ctx.response.body = 'Hello World';

};

运行这个 Demo。



$ node demos/07.js

访问 http://127.0.0.1:3000 ，命令行就会输出日志。



1502144902843 GET /

3.2 中间件的概念

上一个例子里面的 Logger 功能，可以拆分成一个独立函数（完整代码看这里）。



// demos/08.js

const logger = (ctx, next) => {

  console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);

  next();

}

app.use(logger);

像上面代码中的logger函数就叫做"中间件"（middleware），因为它处在 HTTP Request 和 HTTP Response 中间，用来实现某种中间功能。app.use()用来加载中间件。

基本上，Koa 所有的功能都是通过中间件实现的，前面例子里面的main也是中间件。每个中间件默认接受两个参数，第一个参数是 Context 对象，第二个参数是next函数。只要调用next函数，就可以把执行权转交给下一个中间件。

运行这个 demo。



$ node demos/08.js

访问 http://127.0.0.1:3000 ，命令行窗口会显示与上一个例子相同的日志输出。

3.3 中间件栈

多个中间件会形成一个栈结构（middle stack），以"先进后出"（first-in-last-out）的顺序执行。

最外层的中间件首先执行。

调用next函数，把执行权交给下一个中间件。

...

最内层的中间件最后执行。

执行结束后，把执行权交回上一层的中间件。

...

最外层的中间件收回执行权之后，执行next函数后面的代码。

请看下面的例子（完整代码看这里）。



// demos/09.js

const one = (ctx, next) => {

  console.log('>> one');

  next();

  console.log('<< one');

}

const two = (ctx, next) => {

  console.log('>> two');

  next();

  console.log('<< two');

}

const three = (ctx, next) => {

  console.log('>> three');

  next();

  console.log('<< three');

}

app.use(one);

app.use(two);

app.use(three);

运行这个 demo。



$ node demos/09.js

访问 http://127.0.0.1:3000 ，命令行窗口会有如下输出。



>> one

>> two

>> three

<< three

<< two

<< one

如果中间件内部没有调用next函数，那么执行权就不会传递下去。作为练习，你可以将two函数里面next()这一行注释掉再执行，看看会有什么结果。

3.4 异步中间件

迄今为止，所有例子的中间件都是同步的，不包含异步操作。如果有异步操作（比如读取数据库），中间件就必须写成 async 函数。请看下面的例子（完整代码看这里）。



// demos/10.js

const fs = require('fs.promised');

const Koa = require('koa');

const app = new Koa();

const main = async function (ctx, next) {

  ctx.response.type = 'html';

  ctx.response.body = await fs.readFile('./demos/template.html', 'utf8');

};

app.use(main);

app.listen(3000);

上面代码中，fs.readFile是一个异步操作，必须写成await fs.readFile()，然后中间件必须写成 async 函数。

运行这个 demo。



$ node demos/10.js

访问 http://127.0.0.1:3000 ，就可以看到模板文件的内容。

3.5 中间件的合成

koa-compose模块可以将多个中间件合成为一个。请看下面的例子（完整代码看这里）。



// demos/11.js

const compose = require('koa-compose');

const logger = (ctx, next) => {

  console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`);

  next();

}

const main = ctx => {

  ctx.response.body = 'Hello World';

};

const middlewares = compose([logger, main]);

app.use(middlewares);

运行这个 demo。



$ node demos/11.js

访问 http://127.0.0.1:3000 ，就可以在命令行窗口看到日志信息。

四、错误处理

4.1 500 错误

如果代码运行过程中发生错误，我们需要把错误信息返回给用户。HTTP 协定约定这时要返回500状态码。Koa 提供了ctx.throw()方法，用来抛出错误，ctx.throw(500)就是抛出500错误。请看下面的例子（完整代码看这里）。



// demos/14.js

const main = ctx => {

  ctx.throw(500);

};

运行这个 demo。



$ node demos/14.js

访问 http://127.0.0.1:3000，你会看到一个500错误页"Internal Server Error"。

4.2 404错误

如果将ctx.response.status设置成404，就相当于ctx.throw(404)，返回404错误。请看下面的例子（完整代码看这里）。



// demos/15.js

const main = ctx => {

  ctx.response.status = 404;

  ctx.response.body = 'Page Not Found';

};

运行这个 demo。



$ node demos/15.js

访问 http://127.0.0.1:3000 ，你就看到一个404页面"Page Not Found"。

4.3 处理错误的中间件

为了方便处理错误，最好使用try...catch将其捕获。但是，为每个中间件都写try...catch太麻烦，我们可以让最外层的中间件，负责所有中间件的错误处理。请看下面的例子（完整代码看这里）。



// demos/16.js

const handler = async (ctx, next) => {

  try {

    await next();

  } catch (err) {

    ctx.response.status = err.statusCode || err.status || 500;

    ctx.response.body = {

      message: err.message

    };

  }

};

const main = ctx => {

  ctx.throw(500);

};

app.use(handler);

app.use(main);

运行这个 demo。



$ node demos/16.js

访问 http://127.0.0.1:3000 ，你会看到一个500页，里面有报错提示 {"message":"Internal Server Error"}。

4.4 error 事件的监听

运行过程中一旦出错，Koa 会触发一个error事件。监听这个事件，也可以处理错误。请看下面的例子（完整代码看这里）。



// demos/17.js

const main = ctx => {

  ctx.throw(500);

};

app.on('error', (err, ctx) =>

  console.error('server error', err);

);

运行这个 demo。



$ node demos/17.js

访问 http://127.0.0.1:3000 ，你会在命令行窗口看到"server error xxx"。

4.5 释放 error 事件

需要注意的是，如果错误被try...catch捕获，就不会触发error事件。这时，必须调用ctx.app.emit()，手动释放error事件，才能让监听函数生效。请看下面的例子（完整代码看这里）。



// demos/18.js`

const handler = async (ctx, next) => {

  try {

    await next();

  } catch (err) {

    ctx.response.status = err.statusCode || err.status || 500;

    ctx.response.type = 'html';

    ctx.response.body = '<p>Something wrong, please contact administrator.</p>';

    ctx.app.emit('error', err, ctx);

  }

};

const main = ctx => {

  ctx.throw(500);

};

app.on('error', function(err) {

  console.log('logging error ', err.message);

  console.log(err);

});

上面代码中，main函数抛出错误，被handler函数捕获。catch代码块里面使用ctx.app.emit()手动释放error事件，才能让监听函数监听到。

运行这个 demo。



$ node demos/18.js

访问 http://127.0.0.1:3000 ，你会在命令行窗口看到logging error。

五、Web App 的功能

5.1 Cookies

ctx.cookies用来读写 Cookie。请看下面的例子（完整代码看这里）。



// demos/19.js

const main = function(ctx) {

  const n = Number(ctx.cookies.get('view') || 0) + 1;

  ctx.cookies.set('view', n);

  ctx.response.body = n + ' views';

}

运行这个 demo。



$ node demos/19.js

访问 http://127.0.0.1:3000 ，你会看到1 views。刷新一次页面，就变成了2 views。再刷新，每次都会计数增加1。

5.2 表单

Web 应用离不开处理表单。本质上，表单就是 POST 方法发送到服务器的键值对。koa-body模块可以用来从 POST 请求的数据体里面提取键值对。请看下面的例子（完整代码看这里）。



// demos/20.js

const koaBody = require('koa-body');

const main = async function(ctx) {

  const body = ctx.request.body;

  if (!body.name) ctx.throw(400, '.name required');

  ctx.body = { name: body.name };

};

app.use(koaBody());

运行这个 demo。



$ node demos/20.js

打开另一个命令行窗口，运行下面的命令。



$ curl -X POST --data "name=Jack" 127.0.0.1:3000

{"name":"Jack"}

$ curl -X POST --data "name" 127.0.0.1:3000

name required

上面代码使用 POST 方法向服务器发送一个键值对，会被正确解析。如果发送的数据不正确，就会收到错误提示。

2.3 文件上传

koa-body模块还可以用来处理文件上传。请看下面的例子（完整代码看这里）。



// demos/21.js

const os = require('os');

const path = require('path');

const koaBody = require('koa-body');

const main = async function(ctx) {

  const tmpdir = os.tmpdir();

  const filePaths = [];

  const files = ctx.request.body.files || {};

  for (let key in files) {

    const file = files[key];

    const filePath = path.join(tmpdir, file.name);

    const reader = fs.createReadStream(file.path);

    const writer = fs.createWriteStream(filePath);

    reader.pipe(writer);

    filePaths.push(filePath);

  }

  ctx.body = filePaths;

};

app.use(koaBody({ multipart: true }));

运行这个 demo。



$ node demos/21.js

打开另一个命令行窗口，运行下面的命令，上传一个文件。注意，/path/to/file要更换为真实的文件路径。



$ curl --form upload=@/path/to/file http://127.0.0.1:3000

["/tmp/file"]

六、参考链接

（完）

文档信息

2018.07.08: Web Worker 使用教程

一、概述
2018.07.04: 浏览器数据库 IndexedDB 入门教程
一、概述
2018.06.18: JavaScript 的 this 原理
一、问题的由来学懂 JavaScript 语言，一个标志就是理解下面两种写法，可能有不一样的结果。
2018.03.20: Node 调试工具入门教程
JavaScript 程序越来越复杂，调试工具的重要性日益凸显。客户端脚本有浏览器，Node 脚本怎么调试呢？

广告（购买广告位）

留言（92条）

龙卷说：

正在用koa 教程这就来了!

2017年8月 9日 08:35 | # | 引用

韩帅说：

简单易用

2017年8月 9日 09:15 | # | 引用

业余草说：

讲的很详细！
Koa -- 基于 Node.js 平台的下一代 web 开发框架！

2017年8月 9日 09:22 | # | 引用

陈恺垣说：

感谢，之前一直在用express

2017年8月 9日 09:36 | # | 引用

理斯特说：

阮老师为啥不直接介绍 egg.js

2017年8月 9日 09:40 | # | 引用

disguiser 说：

不是很理解为什么要把多个中间件合成为一个

2017年8月 9日 10:26 | # | 引用

MarshallStan 说：

感谢阮一峰老师。

2017年8月 9日 10:33 | # | 引用

wuyang 说：

讲的很详细赞

2017年8月 9日 12:32 | # | 引用

shadow 说：

感谢分享~前几天刚好在入门Koa2

2017年8月 9日 13:38 | # | 引用

csjiabin 说：

koa和express哪个比较好我现在一直在用express 听说koa小想试试

2017年8月 9日 13:50 | # | 引用

郭说：

不太理解为何要做中间件的合成（koa-compose），阮一峰老师，不知这有什么应用的场景？既然都是中间件，都是按顺序执行，为何还有做合成？是方便多个中间件，有公用的部分，可多次应用在不同中间件上？

2017年8月 9日 15:42 | # | 引用

诗与远方说：

正在学习koa2！

2017年8月 9日 15:59 | # | 引用

magicbing 说：

感觉koa和express都是简洁的小框架。
像ror或者django那种大框架好像有sails和adonis，不过感觉也不是很成熟

2017年8月 9日 16:32 | # | 引用

CODE大全说：

阮老师的文章都是图文并茂，而且demo和源码都很详细！koa框架正在学习中！

2017年8月 9日 16:54 | # | 引用

cshenger 说：

阮老师的入门系列一向简介明了

2017年8月 9日 17:49 | # | 引用

cdd 说：

我记得koa文档中koa.request/koa.response是其自身封装的对象吧。koa.req/koa.res是node的对象。

2017年8月 9日 19:38 | # | 引用

李家梁说：

我用koa2几个月了，
路由用的最多的是koa-router，
文件上传可以试试koa-multer

2017年8月 9日 19:43 | # | 引用

久伴我暖说：

膜拜一下前端界的大佬。分享了最新又是值得学习的框架，学习前留个言。

2017年8月 9日 22:05 | # | 引用

MorningTZH 说：

引用龙卷的发言：
正在用koa 教程这就来了!

哈哈哈我也是，瞌睡送枕头呢。

2017年8月 9日 22:40 | # | 引用

宇宙全栈说：

是时候从 express 换到 koa 了！

2017年8月10日 11:41 | # | 引用

Naomi 说：

node 检查出来是6的版本，但是用brew更新的是8的版本，会有影响吗

2017年8月10日 12:22 | # | 引用

MurakamiKennzo 说：

受益匪浅

2017年8月10日 15:55 | # | 引用

阮荣军说：

Mr.阮，能来一发passport的教程么，结合koa 来一发koa-passport模块详细使用教程.

passport 官网 http://www.passportjs.org/

2017年8月10日 16:10 | # | 引用

安晗说：

非常想提升一下自身作为web前端的能力和素质，看了一些帖子，都推荐来看一下阮老师的教程，以后我会多多关注您，把您的教程都好好学习，祝阮老师身体健康，为我们写出更多的精品教程。

2017年8月10日 16:36 | # | 引用

feilong 说：

Error: Cannot find module 'koa' = =，老师怎么回事？

2017年8月10日 17:44 | # | 引用

桂梅桑说：

清晰明了～

2017年8月10日 21:56 | # | 引用

coldxu 说：

阮老师写的太全了，几乎初学所有点都涵盖到了，感谢。

2017年8月10日 22:43 | # | 引用

Phlip 说：

阮老师，求分享算法和互联网架构的内容。

2017年8月11日 14:33 | # | 引用

刘煜说：

引用feilong的发言：
Error: Cannot find module 'koa' = =，老师怎么回事？

你没有安装依赖，在node demos/01.js之前,你需要命令行执行npm install

2017年8月14日 15:05 | # | 引用

distance 说：

好小巧啊~~以前一点点地开始学node.js感觉什么都要自己考虑到，各种处理。后来看了express，使用起来方便多了，也很小巧~~现在又在这里看了koa

2017年8月14日 15:05 | # | 引用

vista-hey 说：

阮老师 ··又是4个多月才等的您的一次更新··但是值得

2017年8月14日 18:03 | # | 引用

wells 说：

引用cdd的发言：
我记得koa文档中koa.request/koa.response是其自身封装的对象吧。koa.req/koa.res是node的对象。

官方文档是这样

2017年8月14日 20:06 | # | 引用

van 说：

3.5 中件是中间件吧，少打了一个字。

2017年8月15日 16:57 | # | 引用

阮一峰说：

@van：谢谢指出，已经改正了。

2017年8月15日 18:12 | # | 引用

kindhj 说：

数据库逻辑处理呢。。？本人小白

2017年8月15日 19:55 | # | 引用

bianhognfei 说：

阮哥你好，你都用什么工具写博客的，我现在也想做一个自己的博客，来写博客。

2017年8月21日 16:23 | # | 引用

ovnrain 说：

引用bianhognfei的发言：
阮哥你好，你都用什么工具写博客的，我现在也想做一个自己的博客，来写博客。

用Koa自己写一个啊^_^

2017年8月23日 18:56 | # | 引用

谢东磊说：

const handler = async (ctx, next) => {
^
SyntaxError: Unexpected token

好几个例子报这样的错误是怎么回事

2017年8月25日 22:29 | # | 引用

~~~ 说：

@谢东磊：

不识别箭头函数吧

2017年8月28日 17:51 | # | 引用

mdz 说：

为什么路由介绍使用的是koa-route没有使用koa-router

2017年8月29日 13:08 | # | 引用

十三说：

koa2 因为需要async await 的原因需要node版本在7以上，koa1不需要

2017年9月 2日 18:09 | # | 引用

hdp 说：

引用谢东磊的发言：
const handler = async (ctx, next) => {
^
SyntaxError: Unexpected token

好几个例子报这样的错误是怎么回事

感觉你node版本太低

2017年9月 8日 13:33 | # | 引用

linzx 说：

DeprecationWarning: Calling an asynchronous function wit
hout callback is deprecated.

3.4节使用async异步编程那里报了这个错，查了下，说这个API废弃了，大家是怎么解决的啊

2017年9月13日 22:53 | # | 引用

达文西12138 说：

有类似Express那种已经搭建好一点的koa框架模板吗？一些404，路由等都配置好了的

2017年9月14日 16:21 | # | 引用

张志成说：

是koa-router不是koa-route，少了个r

2017年9月23日 22:45 | # | 引用

张志成说：

引用张志成的发言：
是koa-router不是koa-route，少了个r

说错了，这两个插件都存在，koa-route貌似是官方的，但是koa-router的star多一点

2017年9月23日 23:29 | # | 引用

老黄说：

引用kindhj的发言：
数据库逻辑处理呢。。？本人小白

sequelize

2017年9月25日 16:40 | # | 引用

海的女儿前端博客说：

用koa架设http服务器的，来看下，以后可能会用到

2017年10月 9日 16:34 | # | 引用

microbingbing 说：

引用业余草的发言：
讲的很详细！
Koa -- 基于 Node.js 平台的下一代 web 开发框架！

为什么是下一代？比express有什么优势么？

2017年10月11日 16:35 | # | 引用

小涛说：

好像有个小的笔误，应该是koa-router, 而不是koa-route

2017年10月14日 10:38 | # | 引用

顿顿说：

06.js 这句是多余的？

app.use(main);

2017年10月21日 00:23 | # | 引用

G小健说：

比官网讲得好。每次有什么问题不懂，发现阮老师写过日志，就安心了

2017年10月25日 16:53 | # | 引用

hackjay 说：

确实看到你的文章比较多，谢谢你的分享，会继续关注你的，希望出些实用的高级课程学学

2017年11月10日 18:08 | # | 引用

GS 说：

koa-route 和 koa-router 两个太像了！阮一峰用的 koa-route，廖雪峰用的 koa-router

2017年11月14日 14:34 | # | 引用

JQ_Chan 说：

我想请问下在异步中间件的demo中main前面还可以增加其他中间件么？怎么加了好像会报错

2017年12月 8日 16:22 | # | 引用

stillyu 说：

5.2表单
ctx.body = ''
写错了

2017年12月21日 12:51 | # | 引用

王说：

koa比express好很多，正在学习node，发现如果用express框架编写程序是要私人的感觉，各种回掉，还是koa比较正常一点，受教了！

2017年12月27日 02:33 | # | 引用

青伢子说：

引用小涛的发言：
好像有个小的笔误，应该是koa-router, 而不是koa-route

两个都是可以的

2018年1月10日 23:45 | # | 引用

金牌红豆说：

太棒了！受益匪浅！！前端学习这个感觉像打开了新世界的大门！！感谢阮老师

2018年1月19日 16:52 | # | 引用

姜珊说：

Koa是默认127.0.0.1的主机名吗？在哪里可以更改

2018年1月25日 20:24 | # | 引用

姜珊说：

koa可以处理PUT请求吗？

2018年1月27日 10:03 | # | 引用

杨毅说：

最后一节的用来上传的那里有点不明白，可以展示一个跟html前台页面结合的上传代码吗

2018年1月29日 15:05 | # | 引用

ranyingxia 说：

求出一个 koa 与 MongoDB 结合的 demo 教程

2018年2月 5日 18:11 | # | 引用

王泽说：

老师您好，我想问下，demos/09.js的示例为什么我执行时触发了两次中间件？我看您的运行结果也只是触发一次呀

2018年2月 8日 22:43 | # | 引用

k 说：

demos/05.js 与 demos/06.js 不完全一样。http://127.0.0.1:3000/aboux 的结果就不一样。

2018年2月20日 13:03 | # | 引用

alisx 说：

5.2 的示例中，中间件main里，并没有 await 表示，为什么main函数需要声明成 async？

2018年2月24日 11:56 | # | 引用

alisx 说：

引用alisx的发言：
5.2 的示例中，中间件main里，并没有 await 表示，为什么main函数需要声明成 async？

我去掉了main的async声明，结果同样有效

2018年2月24日 12:01 | # | 引用

lp 说：

引用郭的发言：
不太理解为何要做中间件的合成（koa-compose），阮一峰老师，不知这有什么应用的场景？既然都是中间件，都是按顺序执行，为何还有做合成？是方便多个中间件，有公用的部分，可多次应用在不同中间件上？

同意！！！！！
求解

2018年2月26日 11:41 | # | 引用

好久不见说：

引用业余草的发言：
讲的很详细！
Koa -- 基于 Node.js 平台的下一代 web 开发框架！

用了好久的express框架，突然需要做一个blog，是基于koa并且用render后端渲染，确实koa是大势所趋

2018年2月26日 11:47 | # | 引用

Sumii 说：

懂了好多，哈哈谢谢！

2018年2月27日 15:19 | # | 引用

1Q84 说：

koa里可以用bootstrap吗？目前没找到较为详细的教程，使用中遇到很多问题

2018年3月 1日 12:52 | # | 引用

ben 说：

求解10.js运行报错是什么原因呢 Unexpected token function

2018年3月20日 11:48 | # | 引用

杨毅说：

使用koa-body上传文件的时候，无法获取其他表单的值，这个要怎么办?

2018年3月27日 09:56 | # | 引用

小迈克说：

一年前还看不懂阮一峰老师的教程，现在感觉简单易懂。

2018年4月 7日 13:34 | # | 引用

嘿嘿说：

经常看阮一峰老师的博客，受益很多

2018年4月 7日 17:12 | # | 引用

Casey 说：

$ curl -X POST --data "name=Jack" 127.0.0.1:3000
{"name":"Jack"}\

curl不是内部或外部命令,这个怎么解决,在window7下

2018年4月10日 09:43 | # | 引用

灵谷说：

今天发了一上午看完，教程简洁明了！入门法宝！非常谢谢老师！在你这里学到了很多东西！学会了很多！所谓“师傅引进门，修行看个人”，在前端这个行业，并没有系统的专业教育（反正我们学校没有），全靠自学和培训~-~。继续奋斗吧！

2018年4月13日 13:50 | # | 引用

wopelo 说：

@lp：

我感觉是因为如果有多个中间件需要使用，那么就得写多个app.use()，使用koa-compose的话直接把中间件写到参数中，最后只需要写一个app.use()即可

2018年4月16日 15:25 | # | 引用

alisx 说：

在5.2的代码示例中第4行
------------------
1 // demos/20.js
2 const koaBody = require('koa-body');
3
4 const main = async function(ctx) {
5 const body = ctx.request.body;
6 if (!body.name) ctx.throw(400, '.name required');
7 ctx.body = { name: body.name };
8 };
-------------------
main 是个异步方法，但从代码来看，没有异步的过程，请问
1 是否没有必要声明 async
2 是否出于未来代码变更考虑，将所有的方法都声明为 async，这样是好还是不好？会有性能或其他问题吗？

谢谢！

2018年4月24日 18:33 | # | 引用

天天说：

引用灵谷的发言：
今天发了一上午看完，教程简洁明了！入门法宝！非常谢谢老师！在你这里学到了很多东西！学会了很多！所谓“师傅引进门，修行看个人”，在前端这个行业，并没有系统的专业教育（反正我们学校没有），全靠自学和培训~-~。继续奋斗吧！

同感！

2018年5月 9日 10:35 | # | 引用

scs 说：

看了后，有了初步的了解，比较简洁。

2018年6月11日 09:37 | # | 引用

dearest 说：

node 必须用7.6以上的版本，写成了 “Koa 必须使用 7.6 以上的版本”

2018年6月21日 14:47 | # | 引用

青格勒说：

我在项目中也开始使用koa了

2018年7月 8日 17:52 | # | 引用

yinsang 说：

5.1 Cookies里面
由于favicon.icon 的http会执行两次，所以views前的数变成1、3、5、7。
需要用route规避一下

2018年7月12日 10:12 | # | 引用

IndraNyo 说：

重定向这里
ctx.response.redirect('/');
ctx.response.body = 'Index Page';

第二行好像不执行已经重定向走了应该在 route.get('/', XXX)的route里写才会输出吧
还是我操作不对？请老师指教

2018年7月31日 14:35 | # | 引用

jackletter 说：

“3.4 异步中间件”部分，
await fs.readFile('./demos/template.html', 'utf8')
显示报错，改成await fs.readFileSync('package.json','utf-8');就好了

2018年8月 8日 11:40 | # | 引用

Ed Me 说：

koa-router 好像更利于项目工程

2018年8月16日 15:37 | # | 引用

Jack Chen 说：

阮老师小弟是看你博客长大的

2018年9月 8日 14:24 | # | 引用

郭小帅说：

引用IndraNyo的发言：
重定向这里
ctx.response.redirect('/');
ctx.response.body = 'Index Page';

第二行好像不执行已经重定向走了应该在 route.get('/', XXX)的route里写才会输出吧
还是我操作不对？请老师指教

我测试了一下，实际上是有执行，但是执行之后被重定向的内容又覆盖掉了。

2018年9月10日 18:08 | # | 引用

意外金喜说：

fs.readFile是回调的方法吧,await后面需要返回 Promise ,回调会报错。

2018年9月13日 14:18 | # | 引用

xiaohuangmao 说：

通俗易懂

2018年9月14日 10:07 | # | 引用

hooper 说：

引用disguiser的发言：
不是很理解为什么要把多个中间件合成为一个

多此一举