diff --git a/doc/docs/guide/question.md b/doc/docs/guide/question.md index cfdcf3fa..0d4ec1d8 100644 --- a/doc/docs/guide/question.md +++ b/doc/docs/guide/question.md @@ -12,7 +12,9 @@
-## 版本问题:[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html) +## 版本问题 + +[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html) - 底层数据库为Mysql8.0+时,flyway执行SQL报错
- Node.js是V16版本时 npm install失败
@@ -38,25 +40,32 @@ - 页面提示“404”
1、确保访问地址无误,根据部署方式的不同 9095/9528 端口皆可以进入项目,如果一个不行试另一个端口
- 2、确定前端是否启动
- 3、确定后端是否启动
+ 2、确定前端(端口号9528)是否启动
+ 3、确定后端(端口号9095)是否启动
4、如果你是前后端分离部署,看看你前端config配置文件中的BASE_API有没有改成你后端的IP端口
5、使用nginx转发遇到问题也是同上

+## 前端npm install失败 + +1、使用node -v检查你的node.js版本,不要使用Node.js16及以上版本。
+2、使用npm get registry查看npm镜像源,将npm镜像设置为淘宝镜像源(百度查具体步骤)。
+3、使用cnpm install命令替换npm install命令进行编译。
+如果以上3步皆无法解决npm编译问题,请直接使用**发行版**。
+ ## 执行源码编译脚本(build.sh)报错 - 提示:“*** report-ui/dist/* *** No such file or directory”
前端编译失败。
- 大部分原因是Node.js版本过高(高于V14),导致前端编译失败。
+ 大部分原因是Node.js版本过高(高于V14),导致前端编译失败(npm install失败),可参考***前端npm install失败*进行解决。
另一部分是Nodejs在编译执行初始化时会去下载一些依赖,如果依赖下载不下来,也会导致失败。

- 提示:“report-core/target/aj-report-*.zip *** No such file or directory”
后端编译失败。
- 可能原因有:Maven版本过低/过高,导致后端编译失败
+ 可能原因有:Maven版本过低/过高,导致后端编译失败。可尝试重新执行编译脚本

@@ -81,17 +90,18 @@
- flyway执行sql相关错误
- 错误提示:** Error creating bean with name 'flywayInitializer' defined in class XXX migration to version V1.0.XXX.sql failed **
+ 错误提示:**Error creating bean with name 'flywayInitializer' defined in class XXX migration to version V1.0.XXX.sql + failed**
解析:flyway在执行某个版本里面包含的sql时报错了
- + - 可能原因:
1、mysql版本问题,在不同版本的mysql中,部分语法可能存在异同
2、mysql配置问题
- + 解决方案: 一、禁用flyway,手动执行已有的各版本sql文件
1、在bootstrap.yml配置文件中找到flyway配置项,如图示
- [img6.png](../picture/qusetion/img_6.png)
+ ![img6.png](../picture/qusetion/img_6.png)
2、将report-core/src/main/resources/db.migration目录下所有的sql文件都执行一次,遇到报错,手动修改sql文件。
3、sql文件中,只有** aj_report **数据库相关的sql是必须的依赖,在确保和aj_report数据库相关sql都执行后在启动服务。
@@ -100,7 +110,7 @@ 2、根据报错提示找到sql文件中具体报错的那一段sql,或者和数据库已有的数据对比,找到没有执行成功的那部分sql
3、手动执行flyway没执行成功的那部分,根据提示,对sql进行修改调整
4、执行完毕后,在aj_report数据库下flyway_schema_history表中找到报错对应的sql文件版本,将对应的success改完1
- [img7.png](../picture/qusetion/img_7.png)
+ ![img7.png](../picture/qusetion/img_7.png)