n8n中Code节点执行卡死问题的分析与解决

n8n是一款流行的开源工作流自动化工具，其Code节点允许用户通过JavaScript代码自定义处理逻辑。近期有用户反馈在Docker环境中部署n8n后，Code节点会出现执行卡死的情况。本文将深入分析该问题的成因并提供解决方案。

问题现象

用户在使用n8n 1.85.4版本时发现：

1. 新建Code节点并使用默认模板代码
2. 执行工作流时节点状态持续显示"Execution is Running"
3. 即使刷新页面也无法恢复
4. 系统环境为Synology DSM 7.0上的Docker容器

根本原因

经过技术分析，问题源于任务运行器(Task Runner)的错误配置。具体表现为：

1. 环境变量N8N_RUNNERS_MODE被设置为无效值"internal_launcher"
2. 同时配置了不存在的N8N_RUNNERS_LAUNTER_PATH路径
3. 这些错误配置导致n8n无法正确初始化内部任务运行器

解决方案

正确的配置方式应为：

1. 仅保留必要的环境变量N8N_RUNNERS_ENABLED=true
2. 移除以下错误配置：
   • N8N_RUNNERS_MODE=internal_launcher
   • N8N_RUNNERS_LAUNCHER_PATH=/usr/local/bin/task-runner-launcher

技术原理

n8n的任务执行系统支持多种模式：

• 内部模式(Internal Mode)：默认方式，由n8n主进程直接执行
• 外部模式(External Mode)：通过独立进程执行任务
• 启动器模式(Launcher Mode)：通过指定路径的启动器执行

当配置错误时，系统会尝试使用不存在的启动器路径，导致任务无法正常启动和执行。

最佳实践建议

1. 生产环境推荐使用n8n 1.89.0或更高版本
2. 简化配置，避免设置不必要的环境变量
3. 对于Docker部署，建议检查所有环境变量的有效性
4. 定期更新n8n版本以获取最新的稳定性修复

该问题已在n8n 1.89.0版本中得到官方修复，建议用户及时升级以获得更好的使用体验。