使用Multer时访问对象嵌套数组的对象属性报TS错误如何解决

TypeScript 中 multer 对 req.files 的默认类型定义为联合类型 { [fieldname: string]: Express.Multer.File[]; } | Express.Multer.File[]，只有调用 single()、array() 等明确返回结构的方法时才会自动收窄类型。你使用 fields() 方法上传多字段文件时，TS 无法自动识别 req.files 的具体结构，因此直接访问 .image 属性会触发类型报错。

方法1：类型断言（快速实现） #

先自定义你上传字段对应的类型，再对 req.files 做类型断言即可正常访问：

// 自定义上传文件的结构类型
interface CustomUploadFiles {
  image?: Express.Multer.File[];
  video?: Express.Multer.File[];
}

// 在路由处理函数 addMovie 中使用
const files = req.files as CustomUploadFiles;
// 访问对应字段的文件
const uploadImage = files.image?.[0];
const uploadVideo = files.video?.[0];

如果你的接口要求必须上传 image 和 video 两个字段，可去掉类型定义中的可选符 ?，访问时也可添加非空断言 ! 跳过空值检测。

方法2：类型守卫（更安全） #

如果你不想做强制类型断言，可以先通过类型判断收窄 req.files 的类型，TS 会自动识别可访问属性：

// 先判断req.files存在且不是数组，说明是字段映射对象
if (req.files && !Array.isArray(req.files)) {
  const uploadImage = req.files.image?.[0];
  const uploadVideo = req.files.video?.[0];
}

你当前日志中文件存储路径出现 undefined（如 ./data/undefined），是因为你的路由配置为 router.post("/")，没有定义 :type 路由参数，导致 req.params.type 取值为 undefined。如果需要按分类存储文件，可以把路由改为 router.post("/:type")，请求时将分类参数放到 URL 路径中即可。

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