TypeScript扩展Express Request对象时无法识别自定义类型文件

方案1：修复express.d.ts的模块识别问题 #

你的express.d.ts中引入了import { Request } from 'express'，这会让文件被识别为模块，导致全局声明块无法正确合并到Express的内置类型中。改成以下两种写法之一即可：

写法A：全局命名空间扩展（需标记为模块）

// src/types/express.d.ts
interface User {
  id: number;
  username: string;
  token_type: string;
}

declare global {
  namespace Express {
    interface Request {
      files?: any;
      user: User;
    }
  }
}

// 必须添加此代码，强制TypeScript将文件识别为模块
export {};

写法B：直接扩展Express模块类型

// src/types/express.d.ts
import 'express';

interface User {
  id: number;
  username: string;
  token_type: string;
}

declare module 'express' {
  export interface Request {
    files?: any;
    user: User;
  }
}

方案2：确保TypeScript正确扫描类型文件 #

检查tsconfig.json，补充include字段显式指定扫描范围（避免隐式规则导致的类型遗漏）：

{
  "compilerOptions": {
    "target": "es2016",
    "module": "commonjs",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true,
    "typeRoots": [
      "./node_modules/@types",
      "./src/types"
    ]
  },
  "include": ["src/**/*"],
  "exclude": [
    "node_modules",
    "dist"
  ]
}

方案3：重启TypeScript服务/编译器 #

• 若使用VS Code开发，按Ctrl+Shift+P执行TypeScript: Restart TS Server，刷新类型缓存；
• 若用ts-node运行项目，重启服务确保新类型被加载。

额外优化：为files指定精确类型 #

如果使用express-fileupload这类文件上传中间件，安装对应类型包npm i -D @types/express-fileupload，然后替换any为精确类型：

import { UploadedFile } from 'express-fileupload';

// 在Request扩展中修改：
files?: UploadedFile | UploadedFile[];

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