解决 n8n 在 Windows 上安装社区节点时 `spawn npm ENOENT/EINVAL` 错误

解决 n8n 在 Windows 上安装社区节点时 spawn npm ENOENT/EINVAL 错误

问题背景

在 Windows 系统上运行 n8n 开发版本时，尝试安装社区节点包时遇到错误：

Failed to execute npm command
Error loading package "n8n-nodes-jimeng" :Failed to execute npm command
Cause: spawn npm ENOENT 或 Cause: spawn EINVAL

环境信息

类别	描述
操作系统	Windows
n8n 版本	2.8.0（源码构建）
Node.js	22.18.0（通过 nvm-windows 安装）
npm 路径	D:\soft\nvm4w\nodejs\npm.cmd
错误位置	community-packages.controller.ts:135:10

问题分析

根本原因

n8n 在调用 child_process.execFile() 执行 npm 命令时，Windows 系统下需要明确的命令扩展名。原始代码如下：

const { stdout } = await asyncExecFile('npm', args, cwd ? { cwd } : undefined);

在 Windows 上，execFile('npm', ...) 会尝试执行 npm.exe，但 nvm-windows 安装的 npm 实际上是 npm.cmd（批处理文件），导致 ENOENT（文件不存在）或 EINVAL（无效参数）错误。

解决方案

方法一：修改 npm-utils.ts（推荐）

修改 packages/cli/src/modules/community-packages/npm-utils.ts 中的 executeNpmCommand 函数：

import { execFile, spawn } from 'child_process';
// ... 其他导入

export async function executeNpmCommand(
 	args: string[],
 	options: NpmCommandOptions = {},
): Promise<string> {
 	const { cwd, doNotHandleError } = options;

 	try {
 		// ============ 关键修改 ============
 		// 使用 spawn 替代 execFile，并指定 npm.cmd
 		return await new Promise<string>((resolve, reject) => {
 			const child = spawn('npm.cmd', args, {
 				cwd: cwd || process.cwd(),
 				shell: true,           // 启用 shell 模式
 				windowsHide: true,     // 隐藏 Windows 控制台窗口
 				stdio: ['pipe', 'pipe', 'pipe'],
 			});

 			let stdout = '';
 			let stderr = '';

 			child.stdout.on('data', (data: Buffer) => {
 				stdout += data.toString();
 			});

 			child.stderr.on('data', (data: Buffer) => {
 				stderr += data.toString();
 			});

 			child.on('close', (code: number) => {
 				if (code === 0) {
 					resolve(stdout);
 				} else {
 					reject(new Error(stderr || `npm exited with code ${code}`));
 				}
 			});

 			child.on('error', (error: Error) => {
 				reject(error);
 			});
 		});
 		// ============ 修改结束 ============
 	} catch (error) {
 		// ... 错误处理代码保持不变
 	}
}

详细步骤

1. 定位问题文件
   D:\code\n8n\packages\cli\src\modules\community-packages\npm-utils.ts

2. 修改 executeNpmCommand 函数

   使用上述方法一进行修改。

3. 重新构建 n8n

   pnpm clean
   pnpm build

4. 启动 n8n

   pnpm start