Multer文件上传中file.size未定义问题的技术解析

问题现象

在使用Multer处理多文件上传时，开发者在filename回调函数中发现file.size属性始终为undefined。通过打印Object.keys(file)发现，可用的属性仅有fieldname、originalname、encoding和mimetype，而期望的size属性缺失。

问题根源

这个问题的根本原因在于Multer的工作机制。Multer是基于busboy构建的，在处理文件上传时分为两个阶段：

1. 初始阶段：当请求到达时，Multer首先从请求的内容处置头(content-disposition)中提取基本信息，包括：

   • 字段名(fieldname)
   • 原始文件名(originalname)
   • 编码类型(encoding)
   • MIME类型(mimetype)

2. 完成阶段：文件实际写入存储后，Multer才会获取完整的文件统计信息，包括文件大小(size)。

技术细节

在Multer的源码实现中，可以清晰地看到这一过程：

1. 初始阶段创建的文件对象仅包含基本属性：

var file = {
  fieldname: fieldname,
  originalname: filename,
  encoding: encoding,
  mimetype: mimetype
}

2. 文件写入完成后，才会通过流(stream)获取实际写入的字节数：

outStream.on('finish', function() {
  cb(null, {
    size: outStream.bytesWritten
  })
})

3. 最后将完整信息合并到文件对象中：

var fileInfo = extend(file, info)

解决方案

对于需要在文件上传过程中获取文件大小的场景，有以下几种解决方案：

1. 后置处理：将数据库操作移到后续中间件中，此时文件已完全上传，可以获取完整的文件信息。

2. 前端预处理：在上传前通过前端JavaScript获取文件大小，并通过自定义请求头或表单字段传递。

3. 流式处理：如果需要实时处理，可以监听数据流并自行计算大小，但这会增加实现复杂度。

最佳实践

对于大多数应用场景，建议采用第一种方案，即在文件上传完成后再进行数据库操作。这种方案不仅能够获取准确的文件大小，还能确保整个上传过程的原子性，避免因上传失败导致数据库中存在不完整记录的情况。

Multer的这种设计实际上是一种合理的权衡，因为在文件完全上传前，服务器无法确定最终的文件大小，特别是考虑到网络传输中可能出现的各种情况。理解这一机制有助于开发者更好地设计文件上传功能。