启用tsconfig的preserveSymlinks修复Joi类型错误却导致Express类型失效

问题描述 #

• 未在tsconfig.json中设置"preserveSymlinks": true时，TypeScript报TS2742错误：commonSchema的推断类型必须引用.pnpm/joi@17.6.2/node_modules/joi，要求添加类型注解
• 开启preserveSymlinks配置后，Joi的类型问题修复，但Express的类型完全失效
• 来回切换该配置会导致两个问题交替出现，可复现仓库已提供，进入apps/backend/src可查看Express类型异常场景

可行解决方向 #

1. 解决Joi的TS2742错误
   手动给commonSchema加明确的类型注解，跳过TypeScript的自动路径推断：

   import Joi from 'joi';
   const commonSchema: Joi.ObjectSchema = Joi.object({
     // 你的schema字段定义
   });
   

   同时检查pnpm依赖结构，确保Joi在工作区被正确共享，避免多实例依赖导致类型推断混乱。

2. 修复Express类型失效问题
   启用preserveSymlinks时，TypeScript可能找不到Express的类型定义，可在tsconfig.json里显式指定类型根目录：

   {
     "compilerOptions": {
       "typeRoots": ["./node_modules/@types", "./.pnpm/node_modules/@types"]
     }
   }
   

   另外确认@types/express已正确安装，版本和Express主包匹配，必要时重新安装：

   pnpm install @types/express --save-dev
   

3. 折中方案
   如果上面的方法都不生效，可以给不同子项目配置不同的tsconfig：Joi相关子项目开启preserveSymlinks，Express相关子项目关闭，通过工作区tsconfig的继承机制实现差异化配置。

内容的提问来源于stack exchange，提问作者Nikola-Milovic