From bf6e18f1de36b88d7102b4d61c2051d184a7f61b Mon Sep 17 00:00:00 2001
From: qianming <isqianming@163.com>
Date: Wed, 9 Nov 2022 14:52:43 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/docs/guide/question.md | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

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 @@
 
 <br>
 
-## 版本问题：[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html)
+## 版本问题
+
+[开发环境参考](https://ajreport.beliefteam.cn/report-doc/guide/quicklyDevelop.html)
 
 - 底层数据库为Mysql8.0+时，flyway执行SQL报错<br>
 - Node.js是V16版本时 npm install失败 <br>
@@ -38,25 +40,32 @@
 
 - 页面提示“404” <br>
   1、确保访问地址无误，根据部署方式的不同 9095/9528 端口皆可以进入项目，如果一个不行试另一个端口 <br>
-  2、确定前端是否启动 <br>
-  3、确定后端是否启动 <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），导致前端编译失败。 <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>
+  可能原因有：Maven版本过低/过高，导致后端编译失败。可尝试重新执行编译脚本 <br>
 
 <br>
 
@@ -81,17 +90,18 @@
 <br>
 
 - flyway执行sql相关错误 <br>
-  错误提示：** Error creating bean with name 'flywayInitializer' defined in class XXX migration to version V1.0.XXX.sql failed ** <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>
-  
+
   解决方案：
   一、禁用flyway，手动执行已有的各版本sql文件 <br>
   1、在bootstrap.yml配置文件中找到flyway配置项，如图示 <br>
-  [img6.png](../picture/qusetion/img_6.png) <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>
 
@@ -100,7 +110,7 @@
   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>
+  ![img7.png](../picture/qusetion/img_7.png) <br>
 
 <br>