|
@@ -12,7 +12,7 @@
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## 版本问题
|
|
|
+## 版本Q&A
|
|
|
|
|
|
[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html)
|
|
|
|
|
@@ -24,138 +24,166 @@
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## 访问相关
|
|
|
+## 编译Q&A
|
|
|
|
|
|
-- 浏览器兼容性 <br>
|
|
|
- 当前未对部分浏览器做兼容性适配,推荐使用谷歌浏览器进行访问。<br>
|
|
|
- 已知:IE白屏、部分版本的火狐浏览器拖动组件出现跳转新页面及无法返回的情况 <br>
|
|
|
-
|
|
|
-<br>
|
|
|
-
|
|
|
-- 部署完进入系统,点击预览大屏,大屏提示:“执行sql失败“ <br>
|
|
|
-  <br>
|
|
|
- 请先重置mysql数据源,将mysql数据源的账号密码修改为你当前系统的账号密码。<br>
|
|
|
+- 前端npm install失败
|
|
|
|
|
|
-<br>
|
|
|
-
|
|
|
-- 页面提示“404” <br>
|
|
|
- 1、确保访问地址无误,根据部署方式的不同 9095/9528 端口皆可以进入项目,如果一个不行试另一个端口 <br>
|
|
|
- 2、确定前端(端口号9528)是否启动 <br>
|
|
|
- 3、确定后端(端口号9095)是否启动 <br>
|
|
|
- 4、如果你是前后端分离部署,看看你前端config配置文件中的BASE_API有没有改成你后端的IP端口 <br>
|
|
|
- 5、使用nginx转发遇到问题也是同上 <br>
|
|
|
+ 1、使用node -v检查你的node.js版本,不要使用Node.js16及以上版本。<br>
|
|
|
+ 2、使用npm get registry查看npm镜像源,将npm镜像设置为淘宝镜像源(百度查具体步骤)。<br>
|
|
|
+ 3、使用cnpm install命令替换npm install命令进行编译。<br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## 前端npm install失败
|
|
|
-
|
|
|
-1、使用node -v检查你的node.js版本,不要使用Node.js16及以上版本。<br>
|
|
|
-2、使用npm get registry查看npm镜像源,将npm镜像设置为淘宝镜像源(百度查具体步骤)。<br>
|
|
|
-3、使用cnpm install命令替换npm install命令进行编译。<br>
|
|
|
-如果以上3步皆无法解决npm编译问题,请直接使用**发行版**。<br>
|
|
|
-
|
|
|
-## 执行源码编译脚本(build.sh)报错
|
|
|
-
|
|
|
-- 提示:“*** report-ui/dist/* *** No such file or directory” <br>
|
|
|
+- 执行源码编译脚本(build.sh)提示:“*** report-ui/dist/* *** No such file or directory” <br>
|
|
|
前端编译失败。<br>
|
|
|
- 大部分原因是Node.js版本过高(高于V14),导致前端编译失败(npm install失败),可参考上面**前端npm install失败**进行解决。 <br>
|
|
|
+
|
|
|
+ 大部分原因是Node.js版本过高(高于V14),导致前端编译失败(npm install失败)。 <br>
|
|
|
另一部分是Nodejs在编译执行初始化时会去下载一些依赖,如果依赖下载不下来,也会导致失败。<br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-- 提示:“report-core/target/aj-report-*.zip *** No such file or directory” <br>
|
|
|
+- 执行源码编译脚本(build.sh)提示:“report-core/target/aj-report-*.zip *** No such file or directory” <br>
|
|
|
后端编译失败。<br>
|
|
|
+
|
|
|
可能原因有:Maven版本过低/过高,导致后端编译失败。可尝试重新执行编译脚本 <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
- 使用eclipse进行源码编译时失败 <br>
|
|
|
+
|
|
|
失败的提示有很多,这里建议换成IDEA <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
- 使用IDEA进行源码编译时提示:“*** openjdk-***” <br>
|
|
|
- 请使用jdk1.8
|
|
|
+
|
|
|
+ 请使用jdk1.8 <br>
|
|
|
+
|
|
|
+<br>
|
|
|
+
|
|
|
+## 启动Q&A
|
|
|
+
|
|
|
+- 双击启动start.bat,提示:“xxx 不是内部或外部命令,也不是可运行的程序 xxx” <br>
|
|
|
+
|
|
|
+ 1、不要将文件放到一个带有空格的目录下 <br>
|
|
|
+ 2、如果文件放在C盘,那么请注意权限 <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## 启动服务相关
|
|
|
+- 日志提示“xxx The driver has not received any packets from the server” <br>
|
|
|
+ 驱动缺失或者对应数据库连接不上<br>
|
|
|
|
|
|
-- 提示“xxx The driver has not received any packets from the server” <br>
|
|
|
- 连不上mysql。<br>
|
|
|
1、确保软件打包正常 <br>
|
|
|
2、mysql版本不兼容,详细看上面关于版本兼容性 <br>
|
|
|
3、bootstrap.yml中配置的mysql地址ip不对 <br>
|
|
|
+ 4、如果通过IDEA启动后端的话,几个bootstrap.yml配置文件的内容都要修改 <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-- flyway执行sql相关错误 <br>
|
|
|
- 错误提示:**Error creating bean with name 'flywayInitializer' defined in class XXX migration to version V1.0.XXX.sql
|
|
|
- failed** <br>
|
|
|
- 解析:flyway在执行某个版本里面包含的sql时报错了 <br>
|
|
|
+- flyway相关错误
|
|
|
|
|
|
- 可能原因:<br>
|
|
|
- 1、mysql版本问题,在不同版本的mysql中,部分语法可能存在异同 <br>
|
|
|
- 2、mysql配置问题 <br>
|
|
|
+错误提示:**Error creating bean with name 'flywayInitializer' defined in class XXX migration to version V1.0.XXX.sql
|
|
|
+failed** <br>
|
|
|
+解析:flyway在执行某个版本里面包含的sql时报错了 <br>
|
|
|
|
|
|
- 解决方案:<br>
|
|
|
- 一、禁用flyway,手动执行已有的各版本sql文件 <br>
|
|
|
- 1、在bootstrap.yml配置文件中找到flyway配置项,如图示 <br>
|
|
|
-  <br>
|
|
|
- 2、将report-core/src/main/resources/db.migration目录下所有的sql文件都执行一次,遇到报错,手动修改sql文件。<br>
|
|
|
- 3、sql文件中,只有** aj_report **数据库相关的sql是必须的依赖,在确保和aj_report数据库相关sql都执行后在启动服务。<br>
|
|
|
-
|
|
|
- 二、保持flyway开启状态,手动执行报错的那个版本sql文件 <br>
|
|
|
- 1、在report-core/src/main/resources/db.migration目录下找到报错的那个版本sql <br>
|
|
|
- 2、根据报错提示找到sql文件中具体报错的那一段sql,或者和数据库已有的数据对比,找到没有执行成功的那部分sql <br>
|
|
|
- 3、手动执行flyway没执行成功的那部分,根据提示,对sql进行修改调整 <br>
|
|
|
- 4、执行完毕后,在aj_report数据库下flyway_schema_history表中找到报错对应的sql文件版本,将对应的success改完1 <br>
|
|
|
-  <br>
|
|
|
+可能原因:<br>
|
|
|
+1、mysql版本问题,在不同版本的mysql中,部分语法可能存在异同 <br>
|
|
|
+2、mysql配置问题 <br>
|
|
|
+
|
|
|
+解决方案:<br>
|
|
|
+一、禁用flyway,手动执行已有的各版本sql文件 <br>
|
|
|
+1、在bootstrap.yml配置文件中找到flyway配置项,如图示 <br>
|
|
|
+ <br>
|
|
|
+2、将report-core/src/main/resources/db.migration目录下所有的sql文件都执行一次,遇到报错,手动修改sql文件。<br>
|
|
|
+3、sql文件中,只有** aj_report **数据库相关的sql是必须的依赖,在确保和aj_report数据库相关sql都执行后在启动服务。<br>
|
|
|
+
|
|
|
+二、保持flyway开启状态,手动执行报错的那个版本sql文件 <br>
|
|
|
+1、在report-core/src/main/resources/db.migration目录下找到报错的那个版本sql <br>
|
|
|
+2、根据报错提示找到sql文件中具体报错的那一段sql,或者和数据库已有的数据对比,找到没有执行成功的那部分sql <br>
|
|
|
+3、手动执行flyway没执行成功的那部分,根据提示,对sql进行修改调整 <br>
|
|
|
+4、执行完毕后,在aj_report数据库下flyway_schema_history表中找到报错对应的sql文件版本,将对应的success改完1 <br>
|
|
|
+ <br>
|
|
|
+
|
|
|
+## 访问Q&A
|
|
|
+
|
|
|
+- 浏览器兼容性 <br>
|
|
|
+
|
|
|
+ 当前未对部分浏览器做兼容性适配,推荐使用谷歌浏览器进行访问。<br>
|
|
|
+ 已知:IE白屏、部分版本的火狐浏览器拖动组件出现跳转新页面及无法返回的情况 <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## 数据集相关
|
|
|
+- 部署完进入系统,点击预览大屏,大屏提示:“执行sql失败“ <br>
|
|
|
+
|
|
|
+  <br>
|
|
|
+ 根据图示,将mysql数据源的账号密码修改为你当前系统的账号密码。<br>
|
|
|
+
|
|
|
+<br>
|
|
|
|
|
|
-## 大屏图表组件相关
|
|
|
+- 页面提示“404” <br>
|
|
|
|
|
|
-- 访问大屏,发现图表X轴、Y轴等显示不出来,但数值、柱子、折线又能显示 <br>
|
|
|
- 问题原因:每个图表,比如X轴、Y轴颜色默认就是白色,当背景色也设置为白色时,就无法显示,其他同理。<br>
|
|
|
+ 1、确保访问地址无误,根据部署方式的不同 9095/9528 端口皆可以进入项目,如果一个不行试另一个端口 <br>
|
|
|
+ 2、确定前端(端口号9528)是否启动 <br>
|
|
|
+ 3、确定后端(端口号9095)是否启动 <br>
|
|
|
+ 4、如果你是前后端分离部署,看看你前端config配置文件中的BASE_API有没有改成你后端的IP端口 <br>
|
|
|
+ 5、使用nginx转发遇到问题也是同上 <br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
-## V1.3.0版本
|
|
|
+## 数据集Q&A
|
|
|
|
|
|
-V1.3.0为多张图表新增了配置项,有部分配置项直接和图表展示相关联,当旧版本升级至此版本后会有部分图表不能正常显示,可参考以下内容进行调整。<br>
|
|
|
-以下方式本质上都是重新载入新图表的配置,如果按以下等方式对图表进行编辑仍不能正常显示图表,建议删了旧图表从新配置。<br>
|
|
|
+## 大屏图表组件Q&A
|
|
|
+
|
|
|
+- 访问大屏,发现图表X轴、Y轴等显示不出来,但数值、柱子、折线等又能显示 <br>
|
|
|
+
|
|
|
+ 原因:每个图表,比如X轴、Y轴颜色默认就是白色,当背景色也设置为白色时,就无法显示,其他同理。<br>
|
|
|
+
|
|
|
+<br>
|
|
|
+
|
|
|
+## 1.2升级V1.3.0
|
|
|
+
|
|
|
+V1.3.0为多张图表新增了配置项,有部分配置项直接和图表渲染相关联,当旧版本升级至此版本后会有部分图表不能正常显示,可参考以下内容进行调整。<br>
|
|
|
+以下方式本质上都是重新载入新图表的配置,对于没提到的图表也可按照相同的方式尝试处理。<br>
|
|
|
+如果按以下等方式对图表进行编辑仍不能正常显示图表,建议删了旧图表从新配置。<br>
|
|
|
|
|
|
- X轴,Y轴不显示-柱体,折线图等含有Y轴配置的的图表 <br>
|
|
|
 <br>
|
|
|
解决方案:<br>
|
|
|
打开Y轴配置项,左Y轴,右Y轴都可以,按图切换“显示”按钮,直到图表Y轴显示,X轴同理。<br>
|
|
|
-  <br>
|
|
|
+ 
|
|
|
+
|
|
|
+ <br>
|
|
|
|
|
|
- 柱状图柱子不显示,或整个图表空白 <br>
|
|
|
 <br>
|
|
|
解决方案:<br>
|
|
|
打开柱体设置,找到“间距”,来回拖动,默认间距值:10。<br>
|
|
|
-  <br>
|
|
|
+ 
|
|
|
+
|
|
|
+ <br>
|
|
|
|
|
|
- 饼图图不显示 <br>
|
|
|
如图示,整个图表空白。<br>
|
|
|
-  <br>
|
|
|
+  <br>
|
|
|
解决方案:<br>
|
|
|
打开饼图设置,拖动"内半径"或者"外半径"。<br>
|
|
|
-  <br>
|
|
|
+ 
|
|
|
+
|
|
|
+ <br>
|
|
|
|
|
|
- 堆叠图图不显示 <br>
|
|
|
解决方案:<br>
|
|
|
选择堆叠样式,进行切换. <br>
|
|
|

|
|
|
|
|
|
+ <br>
|
|
|
+
|
|
|
- 地图图不显示 <br>
|
|
|
解决方案:<br>
|
|
|
打开地图设置,切换文字显示。<br>
|
|
|

|
|
|
|
|
|
+ <br>
|
|
|
|
|
|
+ 如果你的图表配了动态数据,在尝试了上面这些配置修改后依旧没显示图表,手动切到动态数据,点击‘刷新’。<br>
|
|
|
|