在Dify工作流中插入JavaScript节点需拖拽「代码执行」组件并选择JavaScript语言，通过$context访问上下文变量，调试可用console.log、throw错误或返回结构化对象，避免无限循环和async/await等不支持语法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Dify工作流中插入JavaScript节点
打开Dify控制台，进入目标工作流编辑界面，在左侧组件栏找到「代码执行」节点，拖拽至画布空白处。
双击该节点，在语言下拉菜单中选择「JavaScript」，此时编辑区默认启用JS沙箱环境，可安全运行用户脚本。
注意：若未开启沙箱，部分全局对象（如window、document）将不可用，且console.log输出仅在调试日志中可见，不会显示在UI执行面板里。
获取上下文变量的正确写法
在JavaScript节点中，前序节点输出的数据统一挂载在$context对象上，直接访问即可：
立即学习“Java免费学习笔记（深入）”；
const topic = $context.topic;
const user_input = $context.user_input;
不要尝试用inputs或data等非标准字段名——Dify JS沙箱只暴露$context和$inputs两个顶层对象，其中$inputs仅包含「开始节点」原始输入，而$context是全链路累积的运行时快照。若你误写$context.inputs.topic，会返回undefined，后续逻辑可能静默失败。
调试JavaScript节点输出的三种方法
方法一：使用console.log打印关键变量值
在脚本开头或变量处理后添加console.log('topic:', $context.topic);，该日志会在启用DEBUG模式后出现在API返回的node_executions中logs字段内。
方法二：主动抛出错误强制中断并暴露上下文
在可疑位置插入throw new Error(`DEBUG: context keys = ${Object.keys($context).join(', ')}`);，这样节点状态会变为failed，便于在执行历史中快速定位。
方法三：返回结构化调试对象
在脚本末尾写return { debug: true, context_keys: Object.keys($context), topic_length: ($context.topic || '').length };，该返回值会作为该节点的output被下游捕获，也可在执行详情页直接查看。
避免JS节点无限循环的硬性约束
第一步：检查是否在条件分支中误用while(true)或递归调用自身节点名称
第二步：确认所有循环体内部都包含对终止变量的显式更新，例如$context.retryCount = ($context.retryCount || 0) + 1;
第三步：在循环入口处添加计数保护，【若retryCount > 5则必须return { next: 'exit_node' }】，否则Dify不会自动中断，可能耗尽容器资源并触发平台级熔断。
常见语法陷阱与绕过方案
不能使用await或async函数——Dify JS沙箱当前不支持顶层await，所有异步操作需改用fetch配合.then()链式调用。
不能依赖Date.now()做毫秒级精度判断——沙箱内时间函数受容器调度影响，偏差可达200ms以上；如需超时控制，请改用context.variables.start_time与当前$context中已存时间戳比对。
字符串比较务必用===而非==，因为$context.status可能是字符串"true"，而布尔判断$context.status == true会返回false，导致条件分支永远不触发。
