FlyFish 是云智慧开源的一款数据可视化编排平台。通过配置数据模型为用户提供上百种可视化图形组件，零编码即可实现符合自己业务需求的炫酷可视化大屏。 同时，FlyFish 也提供了灵活的拓展能力，支持组件开发、自定义函数与全局事件等配置， 面向复杂需求场景能够保证高效开发与交付。

需注意，本避坑指南仅针对云智慧开源数据可视化平台 FlyFish。如果你也对数据可视化感兴趣，欢迎点击FlyFish，给 FlyFish Star。以及微信添加 xiaoyuerwise 回复飞鱼，加入 FlyFish 开发者交流群一起探讨。

1. Q1：FlyFish 搭建成功后，组件开发模块报错。

A1：组件包未导入，组件包下载地址如下：

https://flyfish-demo.opscloudwise.com:23332/commonComponentDownload

1. Q2：FlyFish2.0 版本前端 NPM 安装依赖包报错

A2：需使用 Node v12 版本 NPM 安装依赖包。

1. Q3：FlyFish 部署启动后报错

A3：需编译 web 项目，并将其正确放置在 www/static 目录下,请先检查此目录下是否有相应的编译之后的代码

1. Q4：NPM 源加载失败

A4：可以去掉当前组件 .npmrc 与 .yarnrc 中内容，此包已发布至 NPM 公源。

1. Q5. 公共组件导出之后重新导入报错

安装配置 FlyFish2.0 版本后，组件先在线操作导出，随后再导入无法正常显示，当前使用的 mysql，redis，code-server，solution_platform，visual_component_platform 均是单独用 dokcer 做镜像在 k8s 上运行。

A5：FlyFish 非公众组件无法进行导出操作，因此会导致上述操作失败。公共组件可以在仓库中进行下载：https://github.com/CloudWise-OpenSource/FlyFishComponents

1. Q6. 组件开发平台 npm run build 报错

A6：出现上述情况需使用 node v12 版本，npm 安装依赖包，进行编译。

1. Q7. 调用公网的 API 存在跨域问题

系统信息如下：

• 浏览器版本: Version 101.0.4951.64 (Official Build) (x86_64)

• 操作系统: CentOS7.6

• Node 版本: NodeJS14.9

A7：开源版本跨域问题需自行使用代理等方式解决，飞鱼企业版内置数据源管理也可解决跨域问题

1. Q8. json 文件导出之后重新导入报错

Demo 环境下将已编辑好的模板 2 json 文件导出后，导入至个人模板 1 时出现报错。系统信息如下：

• 浏览器版本: Version 101.0.4951.64 (Official Build) (x86_64)

• 操作系统: CentOS7.6

• Node 版本: NodeJS12.22

A8：需检查导出的模板是否完整，如有更改，需检查 json 是否符合 JSON 的格式验证。

1. Q9：下载 Demo 环境下模板后，直接放至 tomcat 的 webapps 目录下时访问报错且组件加载失败

系统信息如下：

• 浏览器版本: Version 101.0.4951.64 (Official Build) (x86_64)

• 操作系统: CentOS7.6

A9：需使用 nginx 或者其他方式起服务访问，再确认 config 下 env 的 componentDir 路径是否配置正确。

1. Q10：FlyFish 组件显示问题

A10：组件需编译成功才能显示，请检查 js 代码是否正确。

开源福利

现如今，云智慧已开源数据可视化编排平台 FlyFish 。通过配置数据模型为用户提供上百种可视化图形组件，零编码即可实现符合自己业务需求的炫酷可视化大屏。 同时， FlyFish 也提供了灵活的拓展能力，支持组件开发、自定义函数与全局事件等配置， 面向复杂需求场景能够保证高效开发与交付。

点击下方地址链接，欢迎大家给 FlyFish 点赞送 Star。参与组件开发，更有万元现金等你来拿。

GitHub 地址： https://github.com/CloudWise-OpenSource/FlyFish

Gitee 地址：https://gitee.com/CloudWise/fly-fish

万元现金福利：http://bbs.aiops.cloudwise.com/t/Activity

微信扫描识别下方二维码，备注【飞鱼】加入 AIOps 社区飞鱼开发者交流群，与 FlyFish 项目 PMC 面对面交流～