如何在存在TypeScript错误时终止Next.js编译？

需求合理性 #

你的需求完全合理。TypeScript的核心价值之一就是在编译阶段提前捕获类型错误，避免因遗漏必填属性这类问题导致运行时异常。Next.js默认忽略TypeScript错误继续编译的行为，确实会增加后期排查问题的成本，强制在编译阶段终止错误是合理的工程化实践。

解决配置方案 #

1. 生产构建阶段：阻止错误代码构建 #

修改项目根目录的next.config.js，禁用TypeScript错误忽略：

/** @type {import('next').NextConfig} */
const nextConfig = {
  typescript: {
    // 构建时遇到TypeScript错误直接终止
    ignoreBuildErrors: false,
  },
}

module.exports = nextConfig

同时确保tsconfig.json中启用严格类型检查和错误阻止编译：

{
  "compilerOptions": {
    "strict": true, // 启用严格类型检查模式，确保必填属性等错误被捕获
    "noEmitOnError": true, // 存在错误时不生成编译产物
    // 保留你原有其他配置...
  }
}

2. 开发阶段：实时检测类型错误 #

Next.js开发服务器默认不会强制终止类型错误，你可以通过修改package.json的脚本，同时启动开发服务器和TypeScript实时检查：

{
  "scripts": {
    "dev": "next dev & tsc --noEmit --watch",
    "build": "next build"
  }
}

这样在开发过程中，终端会实时输出TypeScript错误，你可以及时修正，避免错误堆积。

为什么之前的noEmitOnError不生效？ #

Next.js默认使用SWC进行编译，而非直接调用tsc，所以单独设置tsconfig.json的noEmitOnError不会影响Next.js的构建流程。必须通过next.config.js中的typescript.ignoreBuildErrors配置，才能让Next.js在构建时尊重TypeScript错误。

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