FAQ：FlyFish常见问题汇总

[Rosso-Wang]

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

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

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

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

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

Q3：FlyFish部署启动后报错

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

Q4：NPM源加载失败

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

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

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

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

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

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

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

系统信息如下：

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

• 操作系统: CentOS7.6

• Node 版本: NodeJS14.9

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

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

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

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

• 操作系统: CentOS7.6

• Node 版本: NodeJS12.22

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

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

系统信息如下：

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

• 操作系统: CentOS7.6

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

Q10：FlyFish组件显示问题

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

Q11：FlyFish-2.2.0部署成功新建组件可以正常开发使用，但是导入github、gitee FlyFishComponents仓库组件后无法正常使用

原因：
FlyFish-2.2.0不兼容FlyFishComponents中的组件，需要手动修改FlyFishComponents中组件的资源路径和组件ID为对应的占位符。
修改文件包含：editor.html、env.js、index.html、options.json、src/main.js、src/setting.js

FlyFishComponents仓库——标题组件为例
editor.html

<link rel="stylesheet" type="text/css" href="/common/editor.css" />

<script type="text/javascript" src="/components/61b0a25a7f8cf51699105fc7/v-current/env.js"></script>
<script type="text/javascript" src="/common/data-vi.js"></script>
<script type="text/javascript" src="/common/editor.js"></script>

// 修改为
<link rel="stylesheet" type="text/css" href="${EditorCssTpl}" />

<script type="text/javascript" src="${EditorEnvTpl}"></script>
<script type="text/javascript" src="${EditorDataViTpl}"></script>
<script type="text/javascript" src="${EditorJsTpl}"></script>

env.js

componentsDir: 'components',

// 修改为
componentsDir: "${EnvComponentDirTpl}"

index.html

<script type="text/javascript" src="/components/61b0a25a7f8cf51699105fc7/v-current/env.js"></script>
<script type="text/javascript" src="/common/data-vi.js"></script>

// 修改为
<script type="text/javascript" src="${IndexEnvTpl}"></script>
<script type="text/javascript" src="${IndexDataViTpl}"></script>

options.json

"type": "61b0a25a7f8cf51699105fc7",

// 修改为
"type": "${ComponentIdTpl}",

src/main.js

registerComponent('61b0a25a7f8cf51699105fc7', 'v-current',  Component);

// 修改为
registerComponent('${ComponentIdTpl}', 'v-current',  Component);

src/setting.js

registerComponentOptionsSetting('61b0a25a7f8cf51699105fc7', 'v-current',  OptionsSetting);
registerComponentDataSetting('61b0a25a7f8cf51699105fc7', 'v-current',  DataSetting);

// 修改为
registerComponentOptionsSetting('${ComponentIdTpl}', 'v-current',  OptionsSetting);
registerComponentDataSetting('${ComponentIdTpl}', 'v-current',  DataSetting);

操作步骤：
替换文件 —— 压缩组件 —— 导入FlyFish —— 安装依赖 —— 编译组件（Ctrl+S）—— 更新上线

Q12：docker镜像部署问题

FlyFish-2.x 版本docker镜像部署后，所有服务正常，但第一个接口提示登录成功，返回了一个id，第二个接口报错AUTH FAIL

A12：需要将docker-compose flyfishweb里的127的地址改成125的地址。

[Rosso-Wang]

欢迎大家补充：）