You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tanghe-report/doc/docs/guide/question.md

140 lines
5.6 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

## 其他
- 禁用flyway及切换底层数据库方案 <br>
[链接](https://my.oschina.net/u/4517014/blog/5269319) <br>
- 数据源数据集用法总结 <br>
[链接](https://my.oschina.net/u/4517014/blog/5270828) <br>
- 使用Maven Install打包时报错 <br>
![img.png](../picture/qusetion/img.png) <br>
使用Maven Package进行打包 <br>
<br>
## 版本问题
[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html)
- 底层数据库为Mysql8.0+时flyway执行SQL报错<br>
- Node.js是V16版本时 npm install失败 <br>
- jdk使用1.7或者11及以上时编译打包不过 <br>
<br>
![img](../picture/qusetion/img_4.png) <br>
<br>
## 访问相关
- 浏览器兼容性 <br>
当前未对部分浏览器做兼容性适配,推荐使用谷歌浏览器进行访问。<br>
已知IE白屏、部分版本的火狐浏览器拖动组件出现跳转新页面及无法返回的情况 <br>
<br>
- 部署完进入系统点击预览大屏大屏提示“执行sql失败“ <br>
![img](../picture/qusetion/img_3.png) <br>
请先重置mysql数据源将mysql数据源的账号密码修改为你当前系统的账号密码。<br>
<br>
- 页面提示“404” <br>
1、确保访问地址无误根据部署方式的不同 9095/9528 端口皆可以进入项目,如果一个不行试另一个端口 <br>
2、确定前端(端口号9528)是否启动 <br>
3、确定后端(端口号9095)是否启动 <br>
4、如果你是前后端分离部署看看你前端config配置文件中的BASE_API有没有改成你后端的IP端口 <br>
5、使用nginx转发遇到问题也是同上 <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>
前端编译失败。<br>
大部分原因是Node.js版本过高高于V14导致前端编译失败(npm install失败),可参考***前端npm install失败*进行解决。 <br>
另一部分是Nodejs在编译执行初始化时会去下载一些依赖如果依赖下载不下来也会导致失败。<br>
<br>
- 提示“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
<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>
<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>
可能原因:<br>
1、mysql版本问题在不同版本的mysql中部分语法可能存在异同 <br>
2、mysql配置问题 <br>
解决方案:<br>
一、禁用flyway手动执行已有的各版本sql文件 <br>
1、在bootstrap.yml配置文件中找到flyway配置项如图示 <br>
![img6.png](../picture/qusetion/img_6.png) <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>
![img7.png](../picture/qusetion/img_7.png) <br>
<br>
## 数据集相关
- 系统异常,后台日志显示“** Data too long for colum **<br>
查询到的数据太多了,无法入库,这里查询入库的数据只作为在使用动态数据时做解析用 <br>
1、建议不要使用 "select *" <br>
2、一张图表能承载的数据量是有限的太多则图表展示不出来、页面卡死等 <br>
3、必须使用 "select *" ,或者展示很多数据。解决方法,将测试预览的值删掉只剩一条,注意数据的结构 [{}] <br>
## 大屏图表组件相关
- 访问大屏,浏览器白屏 <br>
设计完大屏,保存后进行预览,发现背景全白 <br>
1、回到编辑页面查看大屏背景颜色是否设置 <br>
2、查看大屏的宽高如果宽高都是0大屏背景图片颜色皆无法显示 <br>
3、大屏宽高改成 1920 1080 <br>
<br>