n8n 收到文件却读不到内容：区分二进制文件、JSON 与运行磁盘

从文件本体是否到达开始 一个接口可能只返回文件 URL 或名称，并没有把文件字节带进工作流。建议先查看输入数据结构，区分描述文件的 JSON 与实际二进制内容。若只有链接，先按既有服务协议获取文件；不能把一个地址字符串直接当成已经读取的文档。 三个方向对应不同节点 n8n 官方将文件类数据称为 binary data，并列出三个核心节点：Convert to File 把输入数据输出成文件，Extract From File 把二进制格式提取成 JSON，Read/Write Files from Disk 在运行 n8n 的机器上读写文件。先判断自己的任务是生成、解析还是存储，再选节点。 例如想从附件得到可供条件判断的字段，应先确认解析结果，而不是先把文件另存一次就期待出现字段。想生成可下载文件，则要检查输出文件类型和接收端所需字段。 用一份小文件走完整条转换链 先以两个自拟 JSON 数据项作为输入：customer_id 为“0012”和“0013”，金额分别为 20 和 35。用 Convert to File 生成 JSON 文件，再把这份文件交给 Extract From File 的对应格式操作，比较解析结果中两个客户号与金额是否完整。解析后的外层数组和 item 组织还需按节点输出检查，不能只数执行界面里出现几个方块。 客户号保留前导零，是为了检验后续转换有没有把标识误当数字；金额仍按约定的数值类型核对。文件生成成功但“0012”变成 12，业务上仍然不合格。再将文件内容替换为空文件，确认流程会给出明确异常或按约定处理，而不会生成一条看似有效的空客户记录。 排查字段时，记录输入文件所在的 binary 字段名，并确认解析节点读取同一个字段。只有 JSON 中的 fileName 并不能证明该字段含有文件字节；解析结果也不是原文件本身。把文件本体、文件描述和解析字段分开观察，可以避免在错误层反复改表达式。 磁盘路径属于哪台机器 浏览器能看到本机下载目录，不代表服务器能读取它。自托管容器或远程实例的磁盘路径应由部署环境解释。编辑建议用一份明确放在运行环境可访问位置的测试文件验证路径，再接入正式目录。报文件不存在时先核对机器和挂载位置，不急着修改业务表达式。 区分格式专用处理 文档另外列出 HTML、XML、Compression 和 Edit Image 等节点。选择时按实际内容格式，而非仅看文件扩展名。若解析失败，应记录文件来源、类型与具体失败步骤；空文件或格式不匹配要进入可见错误分支，不能悄悄作为空业务记录继续执行。 较大文件还涉及存储方式 官方提示，自托管二进制数据的存储路径和方式可配置，并会影响扩展能力。本文不提供通用容量设置；若流程从少量附件扩大到持续批量处理，应让部署维护者核对存储方式、清理策略和实际资源占用。 检查交付内容而非仅检查文件出现 建议准备正常文件、空文件、类型错误和较大样例，核对解析后的字段、条数以及转换后的文件能否被目标应用打开。保留源文件标识与处理结果关联，出现争议时可追溯到具体输入。文件成功上传、成功解析和业务字段正确，需要分别验收。

本篇涉及的工具1

n8n

将结构化数据转成文件、解析二进制内容，或访问运行环境磁盘。

适合场景

用 n8n 接收文档、图片或导出文件的自动化维护者。

需要留意

文件 URL 不是文件字节，磁盘路径属于运行 n8n 的机器。

了解项目 访问官网