TypeScript中使用Multer上传图片时如何获取req.files中的特定文件？

问题根源 #

Express默认的Request类型，以及你自定义的AuthenticationRequest都没有包含Multer注入的files属性的正确类型定义。即便运行时req.files是正常的数组/对象，TypeScript也无法识别它的结构，导致编译阶段无法通过索引或字段名访问特定文件。

解决方案 #

1. 全局扩展Express Request类型 #

在项目的类型定义文件（比如src/types/express.d.ts）中添加以下内容，给Express的Request接口补上Multer文件的类型：

import { File } from 'multer';

declare global {
  namespace Express {
    interface Request {
      // 适配Multer的两种files结构：数组（单字段多文件）或对象（多字段上传）
      files?: File[] | Record<string, File[]>;
    }
  }
}

注意：若你的Multer配置是array()（单字段多文件），req.files是File[]；若用fields()（多字段上传），req.files是键为字段名、值为文件数组的对象。

2. 给自定义AuthenticationRequest补全类型 #

如果你的AuthenticationRequest继承自Express的Request，直接确保它继承了扩展后的类型即可；若需要显式声明，可修改你的接口文件：

import { Request } from 'express';
import { File } from 'multer';

interface AuthenticationRequest extends Request {
  user?: YourUserType; // 你的自定义用户字段
  files?: File[] | Record<string, File[]>;
}

export default AuthenticationRequest;

3. 临时应急：类型断言 #

若不想修改全局类型，可在使用req.files时通过类型断言强制指定结构：

if (req.files) {
  // 单字段多文件的情况，断言为数组
  const fileList = req.files as Express.Multer.File[];
  const firstFilePath = fileList[0].path;
  
  // 多字段上传的情况，断言为对象
  const fieldFiles = req.files as { cover: Express.Multer.File[] };
  const coverFile = fieldFiles.cover[0];
}

4. 确认Multer配置匹配类型 #

确保你的Multer中间件配置和req.files的结构对应：

• 单字段多文件：const upload = multer().array('images', 5);
• 多字段上传：const upload = multer().fields([{name: 'cover', maxCount:1}, {name: 'gallery', maxCount:5}]);

验证修改 #

完成类型定义后，即可正常通过索引或字段名访问特定文件：

if (req.files) {
  const paths = (req.files as Express.Multer.File[]).map(file => file.path);
  console.log(paths);
}

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