如何在Koa框架中使用express-validator？启动报错分析

报错信息 #

TypeError: controller.validatee is not a function
    at routes (c:\Users\XXX\gjit\koa-proj\src\main\middlewares\route-path.js:34:51)
    at init (c:\Users\XXX\gjit\koa-proj\app.js:36:6)
    at processTicksAndRejections (internal/process/task_queues.js:93:5)

相关源代码 #

server.js #

const app = require("./app.js");
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`Listening on port: ${PORT}`));

app.js #

const app = new koa();
const middleware = require("./src/main/middlewares/middlewares");
const routes = require("./src/main/middlewares/route-path");
const init = async () => {
  try {
    /*** Step 2: load endpoint routes for the application*/
     routes(router)
     app.use(router.routes())
  } catch (err) {
    console.log({
      err
    });
  }
};
/*** Step 1: load middleware setup - cors,helmet*/
middleware(app);
init();
module.exports = app

middleware.js #

const cors = require("@koa/cors");
const compression = require("koa-compress");
const helmet = require("koa-helmet");
const bodyParser = require("koa-bodyparser");
const sixtyDaysInSeconds = 5184000
function middleware(app) {
  app.use(cors())
  app.use(helmet())
  app.use(helmet.frameguard())
  app.use(helmet.hsts({
    maxAge: sixtyDaysInSeconds
  }))
  app.use(helmet.ieNoOpen())
  app.use(helmet.frameguard({
    action: 'sameorigin'
  }))
  app.use(helmet.noSniff())
  app.use(helmet.referrerPolicy({
    policy: 'same-origin'
  }))
  app.use(helmet.xssFilter())
  app.use(compression());
  app.use(bodyParser()) //koa-body-parser
}
module.exports = middleware;

route-path.js #

const {checkSchema,oneOf} = require("express-validator")
const controller = require("../controller")
function routes(app) {
  app.post("/koatester", controller.validatee(), controller.handler)
}
module.exports = routes

controller.js #

const { header } = require("../../resources/schemas/headers")
const {checkSchema,oneOf} = require("express-validator")
const handler = async function (context) {
  try {    
    let req = context.request
    const errors = validationResult(req)
    if (!errors.isEmpty()) {
      context.status = 422
      context.body = errors
      return ctx
    }
    ctx.status= 200
    ctx.body = "SUCCESS"
    return ctx;
  } catch (error) {
    ctx.status= 500
    ctx.body = "INTERNAL FAILURE"
    }
};

module.exports = () => {
  return async function validatee() {
    [
        checkSchema(header.schema)
    ];  
  }     
}  
module.exports = { handler }

headers.js #

module.exports = {
    header: {
      schema: {
        name: {
          in: ['headers'],
          exists: true,
          isLength: {
            options: {
              min: 1,
              max: 100
            }
          },
          trim: true,
          errorMessage: 'Invalid name. Please provide valid name'
        },
        id: {
          in: ['headers'],
          exists: true,
          isLength: {
            options: {
              min: 2,
              max: 2
            }
          },
          errorMessage: 'Invalid id. Please provide valid id'
        }
      }
    }
  }

问题原因与修复建议 #

1. 直接报错原因：controller.validatee未定义 #

在controller.js中，你先通过module.exports = () => {...}导出了一个返回validatee函数的工厂函数，但随后又用module.exports = { handler }覆盖了这个导出。最终controller对象中只有handler属性，没有validatee，自然会触发is not a function的错误。

2. 核心问题：express-validator不兼容Koa #

express-validator是专门为Express框架设计的校验库，它依赖Express的请求/响应对象结构、中间件回调机制。而Koa的上下文（ctx）模型、异步中间件逻辑和Express完全不同：

• Koa用ctx.request封装请求，而express-validator期望直接操作Express风格的req对象；
• Koa中间件是基于async/await的洋葱模型，express-validator的中间件逻辑无法直接适配；
• validationResult方法无法正确识别Koa的请求对象，无法提取校验结果。

这也是为什么代码在Express中能运行，但在Koa中完全不可行的根本原因。

3. 其他代码问题 #

• handler函数中混用了context和ctx变量：参数是context，但后续代码用了未定义的ctx，会触发额外的ReferenceError；
• app.js中调用routes(router)时，router未定义，需要先引入Koa路由（比如@koa/router）并实例化；
• validatee函数只是定义了checkSchema数组，但没有返回或执行校验逻辑，就算导出成功也无法完成校验。

修复方案 #

• 更换Koa专用校验库：使用koa-validator、@koa/validator或joi这类适配Koa的工具，它们能直接兼容Koa的上下文模型；
• 修正导出问题：如果一定要尝试适配express-validator（不推荐，成本高），需要先把controller.js的导出改为包含validatee和handler：

  // controller.js 修正导出
  module.exports = {
    handler,
    validatee: async () => {
      // 这里需要手动适配Koa上下文和express-validator的校验逻辑
    }
  }
  

• 修复变量错误：统一handler中的变量名，比如都用ctx作为参数；
• 补全路由实例化：在app.js中引入并实例化Koa路由：

  const Router = require('@koa/router');
  const router = new Router();
  

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