夜雨聆风Coze 里 Excel 转图表的工作流，节点拖齐、试运行一上传就红，红字常出现在图表大师那一环。本文按链路复盘：先查读表有没有内容，再查大模型 JSON 是否合图表参数，最后才盯图表映射。
Coze 那条「上传 Excel → 自动出图」的工作流，很多人是按教程把节点拖齐的：开始节点接 File，后面接 readExcel 或 ReadFile，再大模型转 JSON，最后图表大师出图。试运行时表格一上传，后面某一环就红了。红字界面往往停在图表大师，空白图、参数报错、整条链路中断，都容易让人以为图表插件配错了。
我按「上传之后最容易断」把链路从头对过一遍。结论先说：体感上断在图表节点，排查顺序却要先往上走。读表没读出东西，或者大模型吐出来的 JSON 字段对不上图表大师要的格式，到图表那一环才会集中爆出来。教程演示的多半是能跑通的那次，读表引用、sheet 选择、JSON 字段对照，这几步常常一笔带过。
五步链路
开始节点：变量类型设成 File，试运行时上传 Excel。扣子会把文件转成可访问的链接再传给下游。官方文档在讲 LinkReaderPlugin 时写过，开始节点是 File、插件 url 要 String，画布上可能标类型不一致，多数情况可以忽略，平台会把上传文件自动转成 String 链接传下去。；读表插件：商店里常见 ReadFile 的 readExcel，参数一般是 url 和 sheetName。博客园一篇 Coze Excel 转图表实战里写，url 引用开始节点的文件变量，sheetName 不填则读第一个 sheet。输出通常是解析后的表格文本或结构化内容，形态因插件版本略有差异，以你画布上该节点的 output 为准。；大模型节点：输入引用 readExcel 的 output，任务是把表内容整理成图表插件能吃的 JSON。火山引擎开发者社区一篇 Excel 转图表案例里，提示词要求模型输出带 data、xAxis、yAxis、legend、title 等字段的 JSON，并强调「严格按照输出的 json 示例进行结果输出」。掘金上 AI铺子（吾鳴）的教程也列出，图表大师的 line_charts 等子工具，分别要引用大模型输出的 data、xAxis、yAxis、legend、name、title、areaStyle。；图表大师：把大模型各字段逐一映射到插件入参。不同图表类型对应不同子工具，饼图、折线图、柱状图、雷达图各拖一个，参数名不完全一样，以插件详情页为准。；结束节点：引用图表大师输出的图片 URL，常见字段名是 data，试运行成功后复制链接即可。
数据形态变化可以记一句：File → 表内容文本 → JSON 对象 → 图片 URL。中间任何一环空了或歪了，下游都可能「假正常」直到图表才崩。
读表这一环
下面单独说读表，因为教程里最容易被跳过，却是小白第一个堵点。
File 怎么传给 readExcel 的 url，是高频卡点。吾鳴在 AI铺子教程里写得很直白：url 引用「开始」节点的 excel 输入。有人直接填文件名，有人引错变量名，有人引了开始节点但类型选成 String 又去手拼路径。试运行里 readExcel 的 input 看着有值，output 却是空。官方插件常见问题里有一条通用说法：链接类插件输入的 URL 不正确，或 URL 里混进了非 URL 信息，输出可能为 null。Excel 读表虽不是 LinkReader，但「上游给的不是插件真正要的地址或引用」这一类问题，表现很像。
sheetName 是第二个坑。楠木大叔的博客园实战文提到，sheetName 不输入则读第一个 sheet。表有多个 sheet、数据在第二个页签，或者 sheet 名带空格和教程示例不一致，读出来的 output 可能是空表、乱表，或者只有表头。下游大模型对着空内容照样能编一段 JSON，图表大师收到的是「结构像样、数据不对」的参数，于是红在图表节点。
还有一个隐蔽情况：readExcel 节点边框是绿的，你只看了「没报错」就往下走。掘金一篇工作流教程提醒，成功节点边框绿色，失败红色；但绿色只代表这个节点自身执行完，不代表 output 有内容。务必点开节点右上角，看输入 url 实际值、output 有没有行列数据。output 为空时，大模型和图表节点有时不会立刻报致命错，直到图表映射才发现 data 是空的。
像水管的话：图表是龙头，读表是进水口。龙头没水，先查上游有没有进水，别一上来只拧龙头。
三个常见报错位
按因果顺序说，三节之间是连锁反应：A 不对，B 必歪；B 不对，C 必红。所以体感在图表大师，根因常在读表或大模型。
现象：试运行后 readExcel 标红，或节点绿了但 output 为空、只有乱码片段；有时报错信息和 URL、文件解析相关。常见原因：开始节点文件变量没正确引用到 url；sheetName 与实际不符；文件本身格式插件读不了；插件已被下架。扣子官方插件 FAQ 写明，若报「插件已被下架（The plugin has been taken offline）」，错误码 720711011，说明作者下架了该插件，需要删掉节点、换一个可用插件并重新发布。这不是你的表格问题，但界面同样断在插件环节，容易和「Excel 解析失败」混在一起。Debug 动作：试运行后只跑到 readExcel，点开该节点日志。看 input 里 url 是不是一个完整链接，而不是文件名或空。看 output 有没有你表里的列名、几行数据。若 output 空，先改 sheetName 或换一张简单表，纯数据、无合并单元格，做对照，确认是文件问题还是引用问题。若报下架，去插件商店搜同名或同类 readExcel，整条链路替换后再试。
现象：readExcel 有内容，大模型节点绿了或黄了，图表大师报 JSON 相关错、字段缺失、类型不对；有时图表出来是空的或轴标签乱码。常见原因：模型输出不是严格 JSON，或包在 markdown 代码块里；字段名与图表大师入参不一致；数值被输出成带引号的字符串；饼图和折线图用了同一套 schema。掘金一篇《帮新手调试 50+ Coze 工作流》里写，下游报「JSON 解析失败」或「字段不存在」，很大比例是大模型输出格式不稳，建议在大模型后加代码节点做清洗，或把输出约束写死在提示词和输出变量定义里。火山引擎社区那篇案例的示例 JSON 里，xAxis 的 data 甚至写成字符串形式的数组，说明不同教程、不同图表子工具对「数组还是字符串」的要求可能不一致，不能抄一篇提示词就万能套用。Debug 动作：试运行停在大模型节点，展开 output，肉眼看是不是纯 JSON，有没有被 json 代码块包裹。逐字段对照你拖进来的图表子工具：data、xAxis、yAxis、legend、title 是否都有，类型是否匹配。吾鳴教程的做法是给大模型定义结构化输出变量，再让图表大师各参数引用对应字段，比把整段模型文本直接塞给插件稳。若字段齐但图仍错，对照插件详情页，看 pie_charts 和 line_charts 是否要不同的 data 结构。
现象：前面节点都绿，红字和空白图集中在图表大师；报错常出现在参数映射、图表类型、缓存或插件调用上。这也是标题说的「最容易断」，因为链路上所有上游问题，最后都汇总到这里显示。常见原因：大模型 output 的字段名与插件入参绑定了，但中间改名或引用了错误层级，拿到空值或 object Object。掘金那篇调试文写，变量引用路径写错时，运行时可能是空值或对象字符串，需要在报错节点上游看真实数据结构。另一类是图表类型选错：教程搭的是折线图，你拖的是 pie_charts，data 结构不兼容。还有插件下架、额度、超时。官方 FAQ 和 Coze 工作流文档提到插件节点有执行时限，第三方插件异常时整个分支会断。Debug 动作：不要先改图表配色。先确认图表大师每个入参展开后有没有值，特别是 data、xAxis、yAxis。对照大模型 output 同一字段，看是映射断了还是值本身不对。若映射都有值仍失败，换一张极简表、极简提示词，只保留两三行数据，缩小是插件问题还是数据问题。若报插件下架，按 FAQ 换插件并重发工作流。
固定排查顺序
试运行时可以当检查单用，从上往下逐项核对。
开始节点：确认 File 变量名与 readExcel 的 url 引用一致，上传的文件在试运行面板里确实传进去了。；readExcel：单独跑到这一环，看 output 有没有表内容。空就先查 url 引用和 sheetName，再查文件格式和插件是否可用。；大模型：看 output 是否是图表子工具要求的 JSON 结构，字段齐不齐，有没有 markdown 包裹。不对就改提示词或加清洗，别急着改图表参数。；图表大师：逐字段核对映射，确认引的是大模型结构化输出的变量，不是整段文本。图表类型与 data 结构匹配。；结束节点：确认引用的是图表大师返回的图片 URL 字段，复制出来能在浏览器打开。；若仍异常：看发布管理里的消息日志和节点耗时。掘金工作流教程提到，失败节点看错误码和输入输出；超时可能是插件或模型卡住。必要时清浏览器缓存、换一张简单表重跑，排除旧试运行残留。
限制与边界
这条链路一旦跑通，重复做表、出图的时间才会真的省下来，前提是你知道红在哪一环、往上查哪一步。
搭过类似工作流的话，欢迎留言说说最近一次是停在读表、大模型 JSON，还是图表参数映射。觉得有用可以关注本号，后续会继续写工作流踩坑复盘。