文件预览或导入报错如何处理

常见的预览/导入错误码包括 90033（不支持的预览类型）、90035（下载失败）、90042（文件带密码）以及 120016（文件不支持导入）。定位步骤如下：

检查 downloadUrl：确保石墨服务器可访问（公网或专线已打通），返回 HTTP 200，并在响应头中正确设置 Content-Type 或 Content-Disposition。若需要隐藏真实扩展名，请在文件元信息的 ext 字段显式告知。

对照支持格式：参考“文件预览”章节，确认文件属于 .doc/.docx/.xls/.xlsx/.ppt/.pdf/.txt/.jpg/.png/.gif/.svg/.ofd/.md 等受支持格式。其他格式请先在业务系统完成转码。

排除密码/体积限制：错误码 90042、120502、120507 等提示文件设置了密码或单元格数量超限，需提前解密或拆分；90050/90052/120509 则表示文件过大。

监控任务：创建预览或导入任务后记录 taskId，失败时依据“错误码对照”里的解决方案提示用户是否可重试或需人工介入。

大多数报错都源自下载地址不可达或 HTTP 头缺失，先把网络与头信息配置确认正确即可。