n8n 常见问题

常见问题

workflow 导出后导入到另一台机器，凭据还能用吗？凭据需要额外导出，并且目标实例必须使用相同的 N8N_ENCRYPTION_KEY，否则解不开。跨环境迁移前一定要把 key 一起规划好，不要中途更换。

表达式和 Code 节点怎么选？单个字段的取值、拼接、简单格式化用表达式；涉及循环、条件过滤、结构改写、需要调试的用 Code 节点。原则是让读流程的人一眼能看懂数据从哪来。

queue mode 是否一定比单进程快？不一定。它的价值在于隔离与扩容：让 webhook 响应、编辑器操作和重执行任务互不干扰，并且能通过增加 worker 提高总吞吐。流程量很小的场景，单进程反而更好维护。

测试 webhook 和生产 webhook 为什么地址不一样？测试地址只在编辑器处于监听状态时可用，方便边改边调；生产地址在 workflow 激活后才生效，并且要求实例可以从外部访问，配合 WEBHOOK_URL 生成正确的对外地址。

升级要注意什么？先看对应版本的 release note 中关于 breaking change 的部分，在测试实例上用导出的 workflow JSON 做一次完整回归，再动生产。自托管场景下，数据库备份和工作流导出备份要同时做。