无代码与代码的完美融合：n8n JavaScript集成实战指南

【免费下载链接】n8n n8n 是一个工作流自动化平台，它结合了代码的灵活性和无代码的高效性。支持 400+ 集成、原生 AI 功能以及公平开源许可，n8n 能让你在完全掌控数据和部署的前提下，构建强大的自动化流程。源项目地址：https://github.com/n8n-io/n8n 项目地址: https://gitcode.com/GitHub_Trending/n8/n8n

你是否曾遇到这样的困境：使用无代码工具时受限于平台功能，编写纯代码又面临开发效率低下的问题？n8n（Node-Based Automation）作为一款开源工作流自动化平台，通过独特的JavaScript集成能力，让你在可视化界面中享受代码的灵活性。本文将带你探索如何在n8n中无缝融合无代码与JavaScript，构建更强大的自动化流程。

读完本文后，你将能够：

• 在n8n可视化工作流中嵌入JavaScript代码
• 使用表达式编辑器实现动态数据处理
• 掌握代码节点与无代码节点的协同工作
• 解决常见的JavaScript集成问题

n8n工作流基础

n8n采用节点式编程（Node-Based Programming）思想，将复杂的自动化流程拆解为可复用的节点。每个节点代表一个特定功能，通过连接线定义数据流向。这种可视化编程方式极大降低了自动化流程的构建门槛，同时保留了代码的灵活性。

n8n的核心优势在于：

• 400+集成：支持与主流应用和服务的连接
• 混合编程模型：无代码界面与JavaScript代码无缝融合
• 自托管部署：完全掌控数据隐私与安全
• 开源许可：基于Fair-Code许可证，免费使用且可扩展

n8n的安装过程非常简单，只需一行命令即可启动：

npx n8n

或者使用Docker部署：

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

启动后访问http://localhost:5678即可打开n8n编辑器界面。

JavaScript集成核心方式

n8n提供了多种JavaScript集成方式，满足不同场景的需求。从简单的表达式到复杂的代码逻辑，你可以根据实际情况选择最合适的集成方式。

1. 表达式语法

n8n的表达式系统允许你在无代码节点中嵌入动态值，使用=开头标识表达式。这种方式适用于简单的数据转换和逻辑判断，如：

={{ $json["title"].toUpperCase() }}
={{ $node["HTTP Request"].json["total"] * 0.8 }}
={{ new Date($json["createdAt"]).toLocaleDateString() }}

表达式系统基于JavaScript构建，支持大部分标准JavaScript语法和内置对象。n8n对表达式执行环境做了安全限制，禁止使用eval、fetch等可能带来安全风险的函数。

表达式解析逻辑在packages/workflow/src/expression.ts中实现，通过WorkflowDataProxy类提供对工作流数据的访问。

2. 代码节点

对于更复杂的逻辑，n8n提供了专门的"代码"节点（Code Node），支持完整的JavaScript编写。代码节点分为两种类型：

• 函数节点（Function Node）：处理单条数据
• 函数项节点（Function Item Node）：处理多条数据，逐条执行

代码节点支持 require 引入外部npm包，例如：

const moment = require('moment');

// 处理输入数据
items.forEach(item => {
  // 格式化日期
  item.json.formattedDate = moment(item.json.date).format('YYYY-MM-DD');
  
  // 计算总价
  item.json.totalPrice = item.json.quantity * item.json.price;
});

return items;

代码节点的实现可以在nodes-base/nodes/Code/Code.node.ts中找到，核心逻辑是创建一个安全的沙箱环境执行用户代码。

3. 自定义节点

对于需要频繁复用的复杂逻辑，你可以开发自定义节点。自定义节点本质上是封装了特定功能的JavaScript模块，可通过可视化界面配置参数。

自定义节点的基本结构包括：

• 节点定义（JSON）：描述节点属性、参数和输出
• 实现代码（TypeScript/JavaScript）：处理业务逻辑

n8n提供了create-node工具帮助快速生成自定义节点模板。

实战案例：数据处理工作流

让我们通过一个实际案例来展示n8n中JavaScript集成的强大能力。假设我们需要从API获取数据，进行清洗转换后存入数据库。

工作流概览

1. HTTP请求节点：获取原始数据
2. 代码节点：数据清洗与转换
3. 数据库节点：存储处理后的数据

详细步骤

1. 添加HTTP请求节点：配置API端点和参数，获取JSON数据

2. 添加代码节点：处理数据，实现复杂转换逻辑

// 数据清洗和转换
items.forEach(item => {
  // 过滤无效数据
  if (!item.json.email || !item.json.name) {
    item.json.valid = false;
    return;
  }
  
  // 数据标准化
  item.json.name = item.json.name.trim();
  item.json.email = item.json.email.toLowerCase();
  
  // 计算新字段
  const nameParts = item.json.name.split(' ');
  item.json.firstName = nameParts[0];
  item.json.lastName = nameParts.slice(1).join(' ');
  
  // 添加时间戳
  item.json.processedAt = new Date().toISOString();
  
  item.json.valid = true;
});

// 筛选有效数据
return items.filter(item => item.json.valid);

3. 添加数据库节点：将处理后的数据存入数据库

通过这种方式，我们实现了无代码节点（HTTP请求、数据库）与代码节点的完美协作，兼顾了开发效率和功能灵活性。

工作流执行逻辑

n8n工作流的执行逻辑在packages/workflow/src/workflow.ts中定义。核心是Workflow类，负责节点调度和数据流转：

• getStartNode()：确定工作流起始节点
• execute()：执行工作流
• resolveParameterValue()：解析节点参数，包括表达式处理

高级技巧与最佳实践

1. 工作流数据访问

在代码节点中，你可以通过以下对象访问工作流数据：

• $node：访问其他节点的输出

  const previousData = $node["HTTP Request"].json;
  

• $input：当前节点的输入数据

  const inputData = $input.all();
  

• $env：环境变量

  const apiKey = $env.API_KEY;
  

2. 错误处理

良好的错误处理是确保工作流稳定运行的关键。在代码节点中，你可以使用try/catch捕获异常，并通过$node.context.issueError()方法报告错误：

try {
  // 可能出错的代码
  const result = JSON.parse(item.json.data);
  item.json.parsedData = result;
} catch (error) {
  // 报告错误但不中断整个工作流
  $node.context.issueError({
    message: `解析数据失败: ${error.message}`,
    itemIndex: itemIndex,
    level: 'warning'
  });
  
  // 标记错误项
  item.json.parseError = error.message;
}

3. 异步操作

代码节点支持异步操作，只需返回Promise：

// 异步处理示例
async function processItem(item) {
  // 模拟API调用延迟
  await new Promise(resolve => setTimeout(resolve, 1000));
  
  // 异步获取额外数据
  const response = await fetch('https://api.example.com/additional', {
    method: 'POST',
    body: JSON.stringify({ id: item.json.id })
  });
  
  const additionalData = await response.json();
  
  return { ...item.json, ...additionalData };
}

// 处理所有项目
return Promise.all(items.map(async (item, index) => {
  try {
    item.json = await processItem(item);
    return item;
  } catch (error) {
    console.error(`处理项目 ${index} 失败:`, error);
    return item; // 返回原始项目或标记为错误
  }
}));

4. 性能优化

对于处理大量数据的工作流，可采用以下优化策略：

• 使用批处理减少API调用次数
• 避免在循环中使用同步操作
• 利用并行执行处理独立任务
• 合理设置节点超时时间

常见问题与解决方案

1. 表达式语法错误

问题：表达式返回"Invalid expression"错误
解决方案：检查表达式语法，确保使用正确的变量引用方式。可在编辑器中使用表达式助手验证语法。

2. 代码节点执行超时

问题：复杂代码执行时间过长导致超时
解决方案：

• 将长任务拆分为多个节点
• 优化代码逻辑，减少不必要的计算
• 增加节点超时时间设置

3. 数据类型不匹配

问题：节点间数据类型不兼容
解决方案：使用代码节点显式转换数据类型，或在表达式中使用类型转换函数：

={{ Number($json["quantity"]) * Number($json["price"]) }}

4. 外部依赖问题

问题：代码节点中无法引入某些npm包
解决方案：

• 检查包是否与n8n兼容
• 使用自定义节点替代复杂依赖
• 通过Docker部署时预先安装依赖

总结与进阶学习

n8n的JavaScript集成能力打破了无代码与代码之间的壁垒，让普通用户也能构建复杂的自动化流程。通过表达式、代码节点和自定义节点三种方式，你可以在可视化界面中灵活运用JavaScript的强大功能。

进阶学习资源

• 官方文档：docs.n8n.io
• 社区教程：README.md
• API参考：packages/cli/src/command-registry.ts
• 示例工作流：n8n.io/workflows

下期预告

下一篇文章我们将深入探讨n8n的AI功能集成，展示如何利用LangChain构建智能工作流代理。敬请关注！

如果你觉得本文对你有帮助，请点赞、收藏并关注作者，获取更多n8n自动化技巧和最佳实践。

【免费下载链接】n8n n8n 是一个工作流自动化平台，它结合了代码的灵活性和无代码的高效性。支持 400+ 集成、原生 AI 功能以及公平开源许可，n8n 能让你在完全掌控数据和部署的前提下，构建强大的自动化流程。源项目地址：https://github.com/n8n-io/n8n 项目地址: https://gitcode.com/GitHub_Trending/n8/n8n