Hapi.js中使用Joi验证上传文件大小的异常问题

你的核心问题是错误地将Joi校验规则放在了payload配置对象内，导致Hapi没有读取到自定义的maxBytes设置，转而使用默认的1MB（1048576字节）限制。以下是具体修复步骤：

1. 修正配置结构 #

Hapi的路由配置中，payload用于设置文件上传的解析规则（如大小限制、输出格式），而Joi的请求体校验规则必须放在validate.payload下，不能混在payload配置里。

正确的配置示例：

server.route({
  method: 'POST',
  path: '/your-upload-path',
  config: {
    // 配置文件上传参数
    payload: {
      maxBytes: 20715200, // 20MB
      output: 'stream',
      parse: true,
      allow: 'multipart/form-data',
      multipart: true // 必须启用，才能正确解析multipart表单
    },
    // 配置Joi校验规则
    validate: {
      payload: {
        fileData: Joi.binary().max(20715200).required() // 同步设置Joi大小限制，做双重校验
      }
    }
  },
  handler: (request, h) => {
    // 处理上传逻辑
    return h.response('上传成功');
  }
});

2. 检查全局服务器配置 #

如果你的Hapi服务器全局设置了payload.maxBytes，需要确保其值不小于路由级配置的大小，或者直接移除全局限制（路由级配置优先级高于全局）。

全局配置示例（若存在需调整）：

const server = Hapi.server({
  port: 3000,
  payload: {
    maxBytes: 20715200 // 全局设置为20MB，或删除该配置让路由级生效
  }
});

3. 额外排查点 #

修改后重启服务，若仍触发413错误：

• 确认请求的Content-Type确实是multipart/form-data
• 检查是否有反向代理（如Nginx）设置了请求大小限制，这类外部限制会覆盖Hapi的配置

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