TypeScript环境下Express与Passport合并Request的user属性声明时提示修饰符不一致

TypeScript接口合并有强制规则：同一接口下的同名属性，修饰符、类型定义必须完全一致，否则就会触发声明冲突报错。
你遇到的报错本质是两处定义不匹配：

• Passport在合并到Express.Request的接口定义中，把user属性定义为可选（带?标记），类型是它预留的空Express.User接口；
• 你自己写的声明把user定义为必填属性，类型直接写死为{ id: string }，既和Passport定义的可选修饰符不一致，也和预设的Express.User类型不兼容，因此触发“所有user声明必须有一致修饰符”的报错。

Passport本身就为自定义用户结构预留了扩展点——它代码里那个空的Express.User接口，就是专门给开发者做类型扩展的，完全不需要直接修改Express.Request上的user属性定义：

• 新建全局类型声明文件（比如路径为types/express/index.d.ts），写入如下代码：

  declare global {
    namespace Express {
      // 合并Passport预留的空User接口，补充你业务中的用户字段即可
      interface User {
        id: string;
        // 可按需补充其他业务字段，比如用户名、邮箱、角色等
        username: string;
        email: string;
      }
    }
  }
  // 必须加这句，让TS把文件识别为模块，全局声明才会生效
  export {}
  

• 检查项目tsconfig.json配置，确保自定义类型文件能被TS扫描到：
  • 确认include字段覆盖了存放自定义类型文件的目录（比如./types）
  • 或在compilerOptions.typeRoots中追加自定义类型目录的路径

• 彻底删除之前写在Express.Request里的user: { id: string }声明，这是和Passport声明直接冲突的根源，保留的话会持续触发类型报错
• 不要手动修改Passport定义的user?可选属性的修饰符，保持和Passport原定义一致即可；通过扩展底层的Express.User接口，TS会自动把req.user的类型推导为你补充的结构，不需要重复定义
• 全局.d.ts文件如果不带export {}，TS会将其视为全局脚本而非模块，其中的命名空间扩展会失效

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