Node 18.17.1 Windows内置文件系统监视器崩溃问题求助

你遇到的ERR_INVALID_ARG_TYPE错误是Windows系统下Node.js内置文件系统监视器（FSWatcher）的专属Bug，根源在于Windows文件系统的操作特性和Node.js原生监视逻辑的冲突，在多监视器联动（比如你这里esbuild+Node.js双监视）的场景下更容易触发。以下是可行的解决方法：

• 强制使用轮询式文件监视
  Node.js在Windows默认依赖系统原生的文件变更通知API，这个API在处理文件快速创建/删除时可能返回空路径。可以通过两种方式切换到轮询模式：

  • 启动Node时添加参数：node --watch --watch-poll dist/index.js，--watch-poll会让Node定期扫描文件系统代替原生通知，稳定性更高（会轻微增加CPU占用，大部分场景可忽略）。
  • 设置环境变量：在命令行执行set NODE_WATCH_FS=poll，之后启动Node的--watch模式会自动使用轮询。

• 调整esbuild的输出策略
  esbuild在输出文件时的快速覆盖/重命名操作，可能导致Windows的文件监视器捕获到不完整的文件状态。可以修改配置，采用原子写入避免路径异常：

  // 示例：用原子写入代替直接输出
  const esbuild = require('esbuild');
  const fs = require('fs');
  const path = require('path');
  
  esbuild.build({
    entryPoints: ['src/index.js'],
    write: false, // 不直接写入文件
    outfile: 'dist/index.js',
  }).then(result => {
    // 先写入临时文件，再替换目标文件
    const tempPath = path.join('dist', '.temp.index.js');
    fs.writeFileSync(tempPath, result.outputFiles[0].contents);
    fs.renameSync(tempPath, 'dist/index.js');
  });
  

  或者直接使用esbuild的--on-success参数联动Node，避免Node单独监视：

  esbuild --watch src/index.js --outfile=dist/index.js --on-success "node dist/index.js"
  

• 升级Node.js版本
  你当前使用的v18.17.1存在Windows FSWatcher的已知问题，升级到18.x系列的最新补丁版本（比如v18.20.x）或者20.x LTS版本，官方已经修复了多个Windows文件监视相关的Bug。

• 优化监视范围
  避免监视整个输出目录，只指向最终的输出文件，减少不必要的变更触发；同时检查目录权限，确保Node进程有完整的文件读写权限，避免因权限问题导致的文件状态异常。

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