不少用户在尝试Nova AI导出文件时,都曾遇到过“格式不支持”的提示,确实令人困扰。实际上,这类问题的根源通常比较明确:要么是目标格式未在系统白名单中启用,要么是License权限不足——免费版本确实仅支持JSON和CSV。更常见的情况是,你满怀期待地想导出JSON Schema,系统却根本不识别。
那么,Nova AI导出格式不支持时,具体该如何解决这些导出问题?

很多时候,点击导出按钮后毫无反应,或者进度卡在“正在生成”却不报错。这通常是因为你选择的格式(如YAML Schema、自定义模板)触发了校验失败,系统认为该格式不属于标准结构化输出,直接挂起不处理。
确认导出格式是否被Nova AI白名单允许
第一步,先确认你的目标格式是否已被放行。登录Nova AI控制台,进入「Settings」→「Export Configuration」,查看右侧的「Supported Export Formats」列表。只有前面带✅的格式(比如JSON、CSV、Markdown、PDF)才能正常导出。像YAML、TOML、XML这类格式,若未勾选,系统会静默拦截——按钮变灰,且没有任何弹窗提醒,让人无从下手。
关键前提:导出前务必确认当前工作区绑定了有效License。免费版仅开放JSON和CSV,其他格式均处于禁用状态,无论怎么切换都无效。
修复JSON Schema导出失败:强制启用Schema兼容模式
如果你确实需要导出JSON Schema,那么需要走一些特殊路径。
步骤一:在导出弹窗中选择「JSON」,然后点击右下角的「Advanced Options」展开高级设置。
步骤二:勾选「Enable Schema Validation Mode」。此时,下方会动态出现一个「Schema Type」下拉框。
步骤三:从下拉框中选择「OpenAPI 3.1」或「JSON Schema Draft 2020-12」。请务必选对版本,因为选错版本后,后端解析器会直接拒绝,返回HTTP 415 Unsupported Media Type错误,但前端不会显示这个状态码。
步骤四:点击「Export」。生成的JSON文件会自动包含$schema字段及校验元数据,这样才能通过Nova AI的内部校验规则。
PDF导出乱码或缺失中文字符
遇到PDF导出乱码,尤其是中文字符丢失的情况,通常有两种解决方法。
方法一:切换内置PDF引擎。导出前,点击「Export as PDF」旁边的齿轮图标,关闭「Use Browser Print Engine」,启用「Nova PDF Renderer」,再执行导出。浏览器引擎对CJK字体回退支持较差,特别是在Linux或macOS没有中文字体缓存的容器环境下,很容易出现丢字现象。
方法二:手动注入字体映射配置(适用于自托管部署)。编辑部署目录下的config/export.yaml,在pdf节点下添加:
font_fallback: ["Noto Sans CJK SC", "Source Han Sans CN", "sans-serif"]
注意:修改后需重启nova-exporter服务,否则配置不生效。
CSV导出字段被自动转义或换行符损坏
CSV导出最常见的问题是字段被转义,或者换行符造成数据错乱。打开导出设置面板,找到「CSV Delimiter & Encoding」区域,将「Line Terminator」从默认的CRLF改为LF;同时将「Text Qualifier」设为双引号("),并勾选「Escape Special Characters」。
这一步必须执行,否则包含换行符的字段(如日志摘要、错误堆栈)会在Excel中错行,而且部分BI工具(例如Tableau)会因为CR字符解析失败而跳过整行数据。
