后端环境准备并快速启动

注意： 部署/启动后端的过程中如果出现问题，请先在 常见问题 中寻找答案。如仍未解决，请及时在群里咨询。

视频教程(点此观看)

一、环境搭建

1. 需要安装的工具

• JDK
• Maven
• IDEA

注意：以上工具需安装在本地开发电脑上，根据实际情况补充所需工具。

2. 安装 JDK

• 检查是否已安装 JDK

  在终端中执行以下命令：

  java -version

  如果安装了，会出现版本号。
  如果没有安装，请选择以下方式下载 JDK：

  • 官网下载（建议下载 JDK 8, installer）：Oracle JDK下载
  • 部署包中下载：一键下载所有需要的安装包(点击这里)

  安装过程只需一路点击 下一步。

  注意：JDK版本必须高于1.8_221+版本。

• 配置环境变量

  1. 打开 Windows 环境变量配置页：
     • 此电脑 => 右键属性 => 系统高级设置 => 环境变量
  2. 在用户环境变量中新建变量为JAVA_HOME的项,值为JDK安装之后的路径
     • 变量名：JAVA_HOME
     • 变量值：JDK 安装路径
       
  3. 编辑变量为Path的项添加一个值%JAVA_HOME%\bin
     
  4. 在 PowerShell 或 CMD 中验证，输入java -version，输出类似信息为安装配置成功
     

3. 安装 Maven

• 检查是否已安装 Maven

  在终端中执行：

  mvn -v

  如果安装了，会出现版本号。
  如果未安装，请下载 Maven：

  • 推荐安装： Maven 3.6.3 下载
  • 部署包中下载：一键下载所有需要的安装包(点击这里)

• 下载后解压。

• 配置 Maven 私服

  之前解压的数式提供的部署包中有两个settings.xml文件：
  

  根据 Maven 版本选择合适的 settings.xml 文件：

  • 3.6.x 版本使用 settings-3.6.3.xml
  • 3.8.x 版本使用 settings-3.8.x.xml

  具体步骤：

  1. 将对应的 settings-3.x.x.xml 复制到 Maven 安装目录的 conf 文件夹里面。
  2. 如果已有 settings.xml，请将已经存在的settings.xml重命名(随便命)。
     3.然后将 settings-3.x.x.xml 重命名为 settings.xml。

• 配置环境变量

  1. 在用户环境变量中新建变量为M2_HOME的项,值为Maven安装路径
     • 变量名：M2_HOME
     • 变量值：Maven 安装路径
       
  2. 编辑变量为Path的项添加一个值%M2_HOME%\bin
     

• 验证安装

  在终端执行：

  mvn --version

  出现下列信息，表示成功了：
  

  如果仍然不成功，请检查环境变量配置。

4. 下载安装 IDEA

下载方式：

• 官网下载：IDEA下载链接
• 部署包中下载：一键下载所有需要的安装包(点击这里)

二、IDEA 配置

1. 下载 IDEA 插件

有2种方式：

• 在 这个链接中找到下图的位置：
  

  下载对应的插件版本（去除 .txt 后缀）：

• 如果使用了“部署包一键下载”中的 IDEA，那么直接使用“部署包一键下载”中的插件即可：一键下载所有需要的安装包(点击这里)。

打开 IDEA，依次点击菜单项 File => Settings => Plugins，找到下载的插件包。

找到自己前面下载的插件包:

注意：如果安装了 Lombok 插件，请禁用它。

2. IDEA 配置（Maven 配置，Annotation 配置）

先打开数式提供的部署包中的后端工程

1. 设置 Maven 的 settings.xml：
   • Maven home path：设置为下载的 Maven 路径。
   • User settings file：设置为 Maven conf 目录下的 settings.xml。
     
2. 配置 Compiler 为 -Djps.track.ap.dependencies=false。
   
3. 配置 Java Compiler 为 -parameters。
   
4. 配置 Annotation Processors，勾选 Enable annotation processing。
   
5. 编译 Maven 拉取包，执行 mvn install，然后再 reload。
   

3. 项目启动（修改 yml 文件）

1. 修改 bootstrap.yml 中运行环境配置：

   • 将 zk 的 IP 修改为 Docker 安装的宿主机 IP。
   • 默认 profiles 设置为 dev，注意对应的 YML 文件为 application-dev.yml。

     dubbo:
     application:
     name: pamirs-project
     version: 1.0.0
     registry:
     #192.168.0.121->改成docker安装的宿主机IP（也就是服务器的ip）
     address: zookeeper://192.168.0.121:2182

2. 修改 application-dev.yml 中，中间件的 IP 和端口：

   • redis：修改对应redis的IP为 Docker 安装的宿主机 IP。

     spring:
     redis:
      database: 0
      host: 192.168.0.121 #改成docker安装的宿主机IP（服务器IP）
      port: 6378
      timeout: 5000
      password: Abc@1234(默认的不用改)

   • mysql：改成mysql宿主机IP（服务器上的IP）和账号信息

     biz:
     driverClassName: com.mysql.cj.jdbc.Driver
     type: com.alibaba.druid.pool.DruidDataSource
     # mysql宿主机IP（服务器上的IP）
     url: jdbc:mysql://192.168.0.121:3307/demo_biz?useSSL=false&allowPublicKeyRetrieval=true&useServerPrepStmts=true&cachePrepStmts=true&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true
     # 修改用户名和密码
     username: root
     password: Abc@1234
     initialSize: 5
     ...
     pamirs:
     driverClassName: com.mysql.cj.jdbc.Driver
     type: com.alibaba.druid.pool.DruidDataSource
     # mysql宿主机IP（服务器上的IP）
     url: jdbc:mysql://192.168.0.121:3307/demo_pamirs?useSSL=false&allowPublicKeyRetrieval=true&useServerPrepStmts=true&cachePrepStmts=true&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true
     # 修改用户名和密码
     username: root
     password: Abc@1234
     ...
     base:
     driverClassName: com.mysql.cj.jdbc.Driver
     type: com.alibaba.druid.pool.DruidDataSource
     # mysql宿主机IP（服务器上的IP）
     url: jdbc:mysql://192.168.0.121:3307/demo_base?useSSL=false&allowPublicKeyRetrieval=true&useServerPrepStmts=true&cachePrepStmts=true&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true
     # 修改用户名和密码
     username: root
     password: Abc@1234

   • zk：修改对应zk的IP为 Docker 安装的宿主机 IP

     zookeeper:
     zkConnectString: 192.168.0.121:2182  #改成docker安装的宿主机IP（服务器ip）
     zkSessionTimeout: 60000
     rootPath: /demo

   • mq：改成docker安装的宿主机IP（服务器ip）

     spring:
     application:
     name: pamirs-designer
     rocketmq:
     name-server: 192.168.0.121:9876    #改成docker安装的宿主机IP（服务器ip）

   • 如果无代码部署部分配置了协同开发，那么就要加上ownSign （不配协同开发的忽略此步）：

     pamirs:
     distribution:
     session:
      allMetaRefresh: false
      ownSign: shushi     #哥，加上这行。注意shushi的值换成每个人自己的，大家都不要相同

     这个地方大家尤其需要注意下：上面的这个ownSign是配置在每个开发人员自己本地工程中的。但是我们这个协同开发还需要一个公共的测试环境，然后这个测试环境就不需要配置ownSign，但是要配置-PmetaProtected=pamirs指令，详细说明请看：https://doc.oinone.top/backend/14878.html

     4. 启动

     启动成功后，控制台会显示访问的 IP 地址，可复制到浏览器直接访问。
     
     注意：如果配了协同开发，访问的时候需要在浏览器地址后面加上;ownsign=（具体配的值）