TypeScript处理单类型/类型数组：express-fileupload类型报错求解

你遇到的这个问题很典型——当类型是UploadedFile | UploadedFile[]时，TypeScript没办法直接确定你要访问的是单个文件还是数组，所以会报错说数组没有name属性。之前尝试的instanceof Array和typeof判断无效，主要是因为typeof不能直接识别数组类型（typeof []返回的是'object'），而instanceof Array在某些模块环境下可能因为原型链差异不生效，再加上UploadedFile是接口而非类，TS需要更明确的类型守卫来做推断。

下面给你几个靠谱的解决方法：

方法一：用Array.isArray()做类型判断 #

这是TypeScript内置支持的类型守卫，能准确识别数组类型，判断后TS会自动推断变量的具体类型：

const file: UploadedFile | UploadedFile[] = req.files.file;

if (Array.isArray(file)) {
  // 这里TypeScript会自动把file推断为UploadedFile[]类型
  file.forEach(uploadedFile => {
    console.log(uploadedFile.name);
  });
} else {
  // 这里file会被推断为UploadedFile类型
  console.log(file.name);
}

Array.isArray()是ES5原生支持的方法，比instanceof Array更可靠，不会因为模块环境的差异出问题，而且TS能完美识别这个判断逻辑。

方法二：自定义类型守卫 #

如果需要更精确地判断是否为单个UploadedFile类型，可以写一个自定义的类型守卫函数：

// 定义类型守卫函数，告诉TS如何判断一个值是否为UploadedFile
function isUploadedFile(item: UploadedFile | UploadedFile[]): item is UploadedFile {
  // 检查item是否有name属性，且name是字符串类型
  return typeof (item as UploadedFile).name === 'string';
}

// 使用示例
const file = req.files.file;
if (isUploadedFile(file)) {
  console.log(file.name); // 这里file是UploadedFile类型
} else {
  file.forEach(f => console.log(f.name)); // 这里file是UploadedFile[]类型
}

这种方法适合你需要更复杂判断逻辑的场景，比如除了name之外还要检查其他属性是否符合UploadedFile的定义。

方法三：类型断言（谨慎使用） #

如果你能百分百确定当前场景下req.files.file是单个文件或者数组，可以用类型断言直接告诉TS它的类型：

// 确定是单个文件时
const singleFile = req.files.file as UploadedFile;
console.log(singleFile.name);

// 确定是数组时
const fileArray = req.files.file as UploadedFile[];
fileArray.forEach(f => console.log(f.name));

注意：类型断言是跳过TS的类型检查，如果你判断错误，运行时会出现报错，所以只在你完全确定类型的场景下使用。

内容的提问来源于stack exchange，提问作者Dariusz Męciński