如何让Vite build命令在出错时返回非零退出码？

一、把循环依赖导出警告转为构建错误 #

你遇到的那个关于useFoobar重导出的警告，是Rollup的底层提示（Vite基于Rollup构建）。要让这种警告直接终止构建，在vite.config.ts里配置Rollup的警告处理逻辑：

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      onwarn(warning, warn) {
        // 精准匹配你遇到的循环依赖导出警告
        if (warning.code === 'CIRCULAR_DEPENDENCY' && warning.message.includes('reexported through module')) {
          // 抛出错误，让vite build直接失败
          throw new Error(warning.message);
        }
        // 其他警告按默认逻辑处理
        warn(warning);
      },
    },
  },
});

二、让Chunk Size警告触发构建失败 #

针对构建报告里的chunk大小警告，有两种方式让它终止构建：

方式1：自定义Vite插件检查chunk大小 #

自己写个简单插件，在构建结束后校验每个chunk的大小，超过阈值就抛出错误：

import { defineConfig, Plugin } from 'vite';
import react from '@vitejs/plugin-react';

// 自定义插件：强制chunk大小不超过阈值
const enforceChunkSizeError = (): Plugin => ({
  name: 'enforce-chunk-size-error',
  generateBundle(options, bundle) {
    const chunkSizeLimit = 500; // 单位KB，和Vite默认警告阈值一致，可按需修改
    for (const [name, chunk] of Object.entries(bundle)) {
      if (chunk.type === 'chunk' && chunk.code && chunk.fileName.endsWith('.js')) {
        const size = Buffer.byteLength(chunk.code, 'utf8') / 1024;
        if (size > chunkSizeLimit) {
          throw new Error(`Chunk ${name} (${chunk.fileName}) 超出大小限制：${size.toFixed(2)}KB > ${chunkSizeLimit}KB`);
        }
      }
    }
  },
});

export default defineConfig({
  plugins: [react(), enforceChunkSizeError()],
  build: {
    chunkSizeWarningLimit: 500, // 和插件里的阈值保持一致
  },
});

方式2：通过Rollup的onwarn处理警告 #

如果你的chunk大小警告是Rollup直接输出的，也可以在rollupOptions.onwarn里匹配警告信息，转为错误：

build: {
  rollupOptions: {
    onwarn(warning, warn) {
      // 处理chunk size警告
      if (warning.code === 'TOO_BIG' || warning.message.includes('exceeds the recommended size limit')) {
        throw new Error(warning.message);
      }
      // 同时保留之前的循环依赖警告处理逻辑
      if (warning.code === 'CIRCULAR_DEPENDENCY' && warning.message.includes('reexported through module')) {
        throw new Error(warning.message);
      }
      // 其他警告正常输出
      warn(warning);
    },
  },
}

三、GitHub Actions里的配置 #

在你的CI workflow文件（比如.github/workflows/build.yml）里，直接执行vite build就行——现在只要触发上述错误，命令会返回非0退出码，GitHub Actions会自动标记任务失败：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 安装依赖
        run: npm install
      - name: 构建项目
        run: npm run build # 确保package.json里的build命令是"vite build"

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