Gulp指定文件不存在时error事件未触发问题求助

我明白你遇到的困惑——当指定的源文件不存在时，Gulp不仅没触发error事件，反而照常执行到finish，这确实不符合预期。下面我来解释原因并给出几种可行的解决方案：

为什么会出现这种情况？ #

Gulp的gulp.src()方法默认有个allowEmpty配置（Gulp 4+），值为true，这意味着它会自动忽略不存在的文件路径，不会抛出错误。同时gulp-concat在没有输入文件时，也会生成一个空的目标文件，导致流程顺利走到finish阶段。

解决方案1：启用文件不存在时的错误抛出（Gulp 4+推荐） #

只需要在gulp.src()中添加allowEmpty: false配置，这样当任意指定的文件不存在时，Gulp会直接抛出错误，触发你的error监听器，并且终止流程，不会走到finish：

gulp.src(['../a.js', '../b.js', '../c.js'], { allowEmpty: false }) 
  .pipe(concat('destination.js')) 
  .pipe(gulp.dest('destination/path/')) 
  .on('error', (err) => { console.error('Error occurred:', err.message); }) 
  .on('finish', () => { console.log('Success'); });

解决方案2：提前手动检查文件存在性 #

如果你需要更灵活的错误提示，或者使用的是旧版Gulp，可以用Node.js内置的fs模块提前检查每个文件是否存在，再决定是否执行合并流程：

const fs = require('fs').promises;
const path = require('path');

async function concatTask() {
  const targetFiles = ['../a.js', '../b.js', '../c.js'];
  
  // 遍历检查每个文件
  for (const filePath of targetFiles) {
    const fullPath = path.resolve(filePath);
    try {
      // 检查文件是否可访问（存在且有权限）
      await fs.access(fullPath);
    } catch (err) {
      console.error(`Failed to find file: ${filePath}`);
      return; // 直接终止任务，不执行后续合并
    }
  }

  // 所有文件都存在，执行合并
  return gulp.src(targetFiles)
    .pipe(concat('destination.js'))
    .pipe(gulp.dest('destination/path/'))
    .on('finish', () => { console.log('Successfully concatenated files'); });
}

// 注册Gulp任务
exports.concat = concatTask;

针对Gulp 3的额外说明 #

如果你还在使用已经停止维护的Gulp 3，allowEmpty选项不存在，这时候可以使用gulp-fail插件来在空流时抛出错误，或者自定义一个中间件来检查流中的文件数量：

const fail = require('gulp-fail');

gulp.src(['../a.js', '../b.js', '../c.js'])
  .pipe(fail(function(stream) {
    return stream.files.length === 0;
  }, 'No files found to concatenate'))
  .pipe(concat('destination.js'))
  .pipe(gulp.dest('destination/path/'))
  .on('error', () => { console.error('Error'); })
  .on('finish', () => { console.log('Success'); });

不过还是强烈建议升级到Gulp 4，获得更好的兼容性和新特性。

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