nest build执行失败：@nestjs/config存在TS错误但start:dev可正常运行

问题原因 #

npm run start:dev 底层用ts-node直接执行TypeScript代码，默认会跳过部分严格的静态类型检查与第三方库类型校验，所以即便有报错也可以正常启动。npm build 会触发tsc全量编译，对类型合法性、导入导出规范的校验更严格，所以会直接终止构建流程。

解决方案 #

• 版本兼容校验
  @nestjs/config v3 仅支持@nestjs/common、@nestjs/core v10及以上版本，如果你的NestJS核心依赖版本低于v10，需要降级@nestjs/config到v2版本：
  npm install @nestjs/config@2
  如果要使用v3版本的@nestjs/config，同步升级核心依赖：
  npm install @nestjs/common@latest @nestjs/core@latest

• 修正导入方式
  确认所有用到@nestjs/config的文件都是用标准包名导入，不要使用相对路径指向node_modules内的文件：

// 正确写法
import { ConfigModule, ConfigService } from '@nestjs/config';

• 调整tsconfig配置
  在tsconfig.json的compilerOptions中开启skipLibCheck: true，跳过第三方依赖的类型检查，避免非业务代码的类型报错阻断构建：

{
  "compilerOptions": {
    "skipLibCheck": true,
    // 其余原有配置保持不变即可
  }
}

• 清理缓存重新构建
  删除本地依赖缓存与构建产物后重新安装依赖再尝试构建：

rm -rf node_modules package-lock.json dist
npm install
npm run build

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