使用koa-body解析表单时ctx.request.files未定义，仅ctx.request.body可访问如何解决？

嘿，我看你遇到了koa-body解析文件时拿不到ctx.request.files的问题，而且ctx.request.body里只有文件名，这大概率是表单的编码类型没设置对，咱们一步步来解决：

1. 给表单加上正确的enctype属性 #

你的Pug表单里没指定enctype="multipart/form-data"，默认的表单编码类型是application/x-www-form-urlencoded，这种类型只会把文件名传到body里，根本不会处理文件上传。修改你的reg.pug：

form(method='POST' action='/reg' enctype='multipart/form-data')
    label Логин
        input(type="text" id="login" name="login")
    label Почта
        input(type="text" name="mail")
    label Пароль
        input(type="password" name="password")
    label Специализация
        input(type="text" name="specialism")
    label Пол
        select(name="sex")
            option(value="male") Мужрской
            option(value="female") Женский
    label Фото
        input(type="file" name="image")
    button(type="submit" value="Sign up") Sign Up

2. 优化koa-body的配置（可选但推荐） #

虽然你已经开了multipart:true，但可以明确指定文件上传的相关配置，避免踩坑。比如设置上传目录、保留文件扩展名，后续处理文件会更方便。修改reg.js里的bodyParser：

const path = require('path');
const bodyParser = require('koa-body')({
    multipart: true,
    formidable: {
        uploadDir: path.join(__dirname, '../public/uploads'), // 要确保这个目录已创建
        keepExtensions: true, // 保留原文件的扩展名
        maxFieldsSize: 2 * 1024 * 1024 // 限制文件大小，比如2MB，可按需调整
    }
});

记得提前创建public/uploads目录，不然上传时会抛出文件路径不存在的错误。

3. 检查是否有冲突的中间件 #

确保你的app.js里没有其他body解析中间件（比如koa-bodyparser），多个解析中间件会互相干扰，导致文件解析失败。如果有多余的解析中间件，直接移除即可。

测试验证 #

修改完这些后重启服务，再提交表单，此时打印ctx.request.files，应该就能看到包含文件路径、大小、类型等信息的对象了，类似这样：

{
  image: [
    {
      size: 12345,
      path: 'public/uploads/SnWyoGZWgDA.jpg',
      name: 'SnWyoGZWgDA.jpg',
      type: 'image/jpeg',
      ...
    }
  ]
}

这样应该就能解决你的问题啦！

内容的提问来源于stack exchange，提问作者Абдулла