Node.js升级至16.18.0后Request与File类型找不到问题

开发者阿泽

2026-8-13

Node.js 16.18.0升级后TypeScript类型错误解决方法

错误1：Request类型找不到

原因

@types/node版本停留在14.x，和Node.js 16.18.0不兼容，导致类型定义冲突或缺失
TypeScript 4.1.5版本过低，对新版Node.js及相关依赖的类型支持不足
可能缺失@types/express依赖（NestJS基于Express，必须依赖该类型定义）

解决步骤

升级@types/node到适配Node.js 16的版本：
```
npm install @types/node@16 --save-dev
```
升级TypeScript到兼容版本（推荐4.9.x及以上）：
```
npm install typescript@^4.9 --save-dev
```
确保@types/express已安装，未安装则执行：
```
npm install @types/express --save-dev
```
确认代码中Request的导入来源正确：
```
import { Request } from 'express';
```

错误2：File类型name属性不存在

原因

你误用了浏览器环境的File API类型，Node.js中没有这个类型；同时parentDir参数用File类型也是错误的，Node.js文件操作需要的是字符串格式的路径。

解决步骤

替换错误类型：根据业务场景定义自定义类型，比如处理上传文件时可以用：

// 自定义上传文件信息类型
interface UploadedFile {
  name: string;
  // 可添加其他需要的属性，如路径、大小等
}

修正方法参数类型：

public saveMediatorLog(parentDir: string, instanceId: string, content: UploadedFile) {
  const srcFilePath: string = `${parentDir}/instance_${instanceId}_mediatorLog.tgz`;
  const destFilePath: string = `${parentDir}/${content.name}`;
  // 后续代码保持不变
}