I import-tested 3 n8n workflow templates like they were going to clients. Here's the checklist I use.
说明与用途
作者在干净环境中验证 n8n 工作流模板,修复错误,并提供检查表以确保客户就绪。
问题
Workflow templates for sale often fail on real deployments because they are only tested in the author’s environment.
结果
The author identified eight bugs across three templates, fixed them, and produced a reusable checklist that ensures templates are client‑ready.
工作流
- Spin up a clean‑room n8n 2.42.5 Docker instance with no credentials or extensions.
- Import the workflow via CLI (
n8n import:workflow) and verify zero import errors. - Walk every branch of every If/Switch node and confirm each branch can execute.
- Search the JSON for
{{placeholders that survive import and ensure each is interpolated or documented. - Confirm no node writes outside allowed paths (e.g., /tmp is blocked in n8n 2.x).
证据
Most workflow templates for sale are hello‑world demos: they import, the canvas looks nice, and the first real run explodes.
Clean‑room n8n instance. I spun up n8n 2.42.5 in Docker — no credentials, no prior workflows, no extensions.
Import via the CLI (n8n import:workflow) with no credentials attached. It must import clean — zero errors — before anything else.
Walk every branch of every If/Switch node and confirm each branch actually executes.
Grep the JSON for {{ placeholders that survive import. Every one must either interpolate from a config node or be documented in the README as buyer setup.
Confirm no node writes outside allowed paths. n8n 2.x blocks /tmp by default, so a template that writes there works on the author's machine and nowhere else.
An If-node routed on largerEquals / smallerEquals operators that don't exist in n8n. The condition silently evaluated so the workflow always took the after-hours branch — the entire AI-reply path could never fire.
The workflow wrote its CSV to /tmp, which n8n 2.x blocks by default. Changed to a documented, allowed location.
Each pack goes out as workflow.json + README + per-credential setup guide + demo script, with sticky-note documentation inside the workflow itself.
- 记录日期: 2026-10-10T04:41:13.485Z