文档中心

Viking AI 搜索

常见问题排查手册

数据集相关

本文档是一篇旨在解决火山引擎数据服务中常见问题的故障排查指南。它将围绕数据导入、处理、使用等核心环节，帮助您快速定位问题、找到解决方案。

核心价值

快速定位问题：通过归类的故障场景，迅速找到您遇到的问题。

提升处理效率：提供明确的排查步骤和解决方案，减少问题处理时间。

典型应用场景

数据导入与同步：解决数据同步失败、数据量不一致等问题。

数据处理与展示：排查图片处理慢、链接无法访问、前端展示异常等故障。

数据处理常见问题排查指南

数据同步失败

基于错误码信息排查

错误码	错误码含义	排查项
InvalidParameter	参数无效	account_id、dataset_id是否正确 dataset_id是否已经配置完成
ErrCodeInvalidRequestBody	请求反序列化失败	请求格式是否正确。正确格式示例见：https://www.volcengine.com/docs/85296/2123234?lang=zh
InvalidMediaCoverUrlError	视频/图片链接失效或无法访问	把链接复制到浏览器看是否可以打开。要换成可以打开的链接
VideoSizeExceedsLimitError	视频大小/时长超过限制	（最大10GB/3.5小时）
ErrCodeInternalServiceError	服务端内部错误，可能由超时或网络波动导致	建议客户端增加重试机制并延长超时配置

数据处理慢

当前对于图文数据，耗时主要在图片的处理。平台会根据 URL 从客户侧把图片下载下来，转存到 AI 搜索引擎环境，然后做图片校验，resize 和 VLM 增强处理。

原因	建议
客户侧 CDN 限频原因，导致下载耗时长或需要多次重试一条数据中图片的数量和大小，数量越多，大小越大，处理耗时越长	请耐心等待。如果您有大量数据上传需求，且能保证自身 CDN 能力，可以联系我们调大并发，加快速度。

数据详情显示数据异常，显示【图片链接无法访问】

数据详情里的【图片链接无法访问】是指火山没有成功拉取到图片，不一定是图片url打不开。客户可依次check：

注意图片链接一定是图片，不能是网页链接地址，否则会数据校验异常，索引失败，无法使用的。

请在您的 CDN 服务商控制台检查 IP 访问控制（黑白名单）配置，确认没有封禁 AI 搜索引擎 IP。具体 IP 地址请联系我们获取。该IP是火山引擎服务用于拉取您图片资源的服务器地址，如果您的 CDN 策略封禁了此IP，将导致图片拉取失败。（备注：如果图片源不归客户所有，无法加白IP，建议使用Base64格式）

数据集的数据量和导入的数据量不一致

原因	建议
数据集的数据量是根据物品主键去重过的，如果客户重复上传数据，就会出现导入的数据量大于数据集数据量	调用listitem接口查询数据集已有的物品，可以选择把没有的物品重新导入。详见：ListItems - 获取数据集中的数据列表

行为数据量突然暴涨的可能原因

火山引擎不会对客户行为数据做增加，所以一般就是客户上传了这么多行为数据，有几种可能原因：

数据集-操作记录-找不到对应的上传记录？

操作记录只记录最近7天的上传记录，所以7天外的不展示是符合预期的，如果7天内的不展示可以联系火山引擎技术支持进行排查。

在体验界面，显示“图片不存在”或“403”

直接复制图片链接到浏览器地址栏，若能正常显示，在体验界面图片无法显示的原因是防盗链限制。客户的图片服务器没有对火山引擎域名开放访问权限。

建议：

客户在CDN上配置允许火山引擎域名访问，域名地址：https://console.volcengine.com/

可以支持爬取检索HTML网页信息么？

暂不支持。需要客户把包含的信息提取成结构化的数据。

最近更新时间：2026.08.09 01:07:02

这个页面对您有帮助吗？

有用

无用