## 其他

- 禁用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、确定前端是否启动 <br>
  3、确定后端是否启动 br>

<br>

## 执行源码编译脚本（build.sh）报错

- 提示：“*** report-ui/dist/* *** No such file or directory” <br>
  前端编译失败。<br>
  大部分原因是Node.js版本过高（高于V14），导致前端编译失败。 <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执行报错1.0.10sql失败 <br>
  错误提示：Caused by: org.flywaydb.core.api.FlywayException: Validate failed: Detected failed <br>
  migration to version 1.0.10 (create report share) <br>
  请参考此 [Issue](https://gitee.com/anji-plus/report/issues/I47JNE) 解决此问题 <br>

<br>

## 数据集相关

- 系统异常，后台日志显示“** Data too long for colum ** ” <br>
  1、建议不要使用 "select *"  <br>
  2、一张图表能承载的数据量是有限的，太多则图表展示不出来、页面卡死等 <br>
  3、必须使用 "select *" ，或者展示很多数据。解决方法，将测试预览的值删掉只剩一条，注意数据的结构 [{}] <br>

## 大屏图表组件相关

- 访问白屏 <br>
  设计完大屏，保存后进行预览，发现背景全白 <br>
  1、回到编辑页面，查看大屏背景颜色是否设置 <br>
  2、查看大屏的宽高，如果宽高都是0（大屏宽高在设计时，有概率性变成0，不知原因）大屏背景图片，颜色，皆无法显示 <br>
  3、大屏宽高改成 1920 1080 <br>

<br>

- 文本框颜色无法改变 <br>
  使用文本框，改变颜色，无法改变。已知有概率性的出现无法修改文本框颜色的情况，因为无法重现，暂时不能排查到是哪里问题。解决方法有以下 <br>
  1、保存退出大屏，重新进入大屏修改文本框颜色 <br>
  2、删掉文本框，重新拖动一个 <br>