跳到主要内容

错误码说明

本文档列出了 Filez JS SDK 在使用过程中可能遇到的错误码及其说明，帮助您快速定位和解决问题。

通用错误​

错误码原因详细说明
1001选择器对应的元素不存在传入 mount/connect/addListener/removeListener 的 selector 对应的 DOM 元素不存在，请检查选择器是否正确
1002文档 iframe 不存在传入 connect 的 selector 对应的元素中，文档 iframe 不存在，请确保文档已正确加载
1003事件类型不支持传入 addListener/removeListener 的事件类型不支持
1004前端集成参数错误传入 mount 的前端集成参数错误，请检查参数格式和值是否正确
1005文档未能成功加载文档未能成功加载，可能是网络问题或文档资源不可用
1006API 参数校验错误调用 API 时参数初步校验失败，请检查参数类型、必填项和基本格式是否符合 API 文档要求
1007API 参数边界校验错误调用 API 时参数内部细化校验失败，参数值可能超出有效范围或不符合产品规则限制
1008API 已废弃调用了已废弃的 API，请使用新版本的 API 替代
1009API 调用超时调用 API 超时，请检查网络连接或稍后重试
1010白名单配置错误白名单配置错误，请参考 白名单配置 文档检查配置

常见问题排查​

1. 错误码 1001​

问题：DOM 元素不存在

解决方案：

  • 确保在 DOM 加载完成后再调用 SDK 方法
  • 检查选择器字符串是否正确，如 #container 或 .doc-container
  • 使用浏览器开发者工具检查元素是否存在于页面中

2. 错误码 1002​

问题：文档 iframe 未找到

解决方案：

  • 确保先调用 mount 方法挂载文档，再调用 connect 方法
  • 等待文档加载完成后再进行连接操作

3. 错误码 1005​

问题：文档加载失败

解决方案：

  • 检查网络连接是否正常
  • 确认文档 URL 是否正确且可访问
  • 查看浏览器控制台是否有其他网络错误

4. 错误码 1010​

问题：白名单配置错误

解决方案：

  • 参考 白名单配置 文档检查配置格式
  • 确保当前域名已添加到白名单中

获取帮助​

如果遇到文档中未列出的错误码，或问题无法解决，请：

  1. 查看浏览器控制台的详细错误信息
  2. 联系技术支持团队获取帮助
最后于 更新