1.mall4j-bbc项目的搭建.md 10 KB

mall4j-bbc:j代表java,java项目,这里面包含了小程序/uniapp/pc/后台vue连接需要的接口。

1.开发环境(要在开发环境打包完成才能放到生产环境,所以开发环境要搭建起来)

以下版本是最低要求的!!! 提问问题前请注意生产环境!!请安装好对应的依赖。

工具 版本
jdk 17
mysql 8.0
redis 5.0+
ElasticSearch 7.xx
xxl-job 3.0.0

2.导入数据库到正式环境

2.1.1 导入数据库之前,先要修改数据库配置

修改配置文件my.cnf

[mysqld]
# 默认使用“mysql_native_password”插件认证
# 如果使用的是mysql 8.0 需要设置 mysql_native_password,不然有些工具连不上
default_authentication_plugin=mysql_native_password
# 关闭 only_full_group_by
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

修改完毕之后,重启mysql服务。

2.2.2 导入数据库(用docker部署,docker启动时会自动初始化,不需要导入)

启动idea,右上角选择open,找到mall4j-bbc的文件夹

idea open

在项目中会有一个 db 文件夹 如图所示:

db文件夹

里面会有很多的数据库文件,按照0、1、2、3的顺序将0schema.sql1yami_bbc.sql2area.sql3xxl_job.sql 导入mysql中。

问:那其他的数据库文件是干嘛的?

答:是更新过了某个时间更新代码时,更新的sql补丁,总数据都在上面四个文件中,所以初始化的时候,只要将四个文件按顺序导入数据库即可。

3. 配置环境信息准备开始打包

对于无法找到文件的用户,推荐使用idea快捷键 ctrl + shift + n 进行文件搜索

  1. 分别修改yami-shop-multishopyami-shop-platformyami-shop-api 下的 \src\main\resources\application-prod.yml 更改为生产环境的数据库账号密码,端口号等(如果是 docker 环境请修改对应的application-docker.yml环境配置文件)

  2. 分别修改yami-shop-multishopyami-shop-platformyami-shop-api 修改yami-shop-admin\src\main\resources\logback-prod.xml 修改里面的PROJECT_PATH/opt/projects/yami-b2b2c 改为自己生产环境的项目路径(如果是 docker 环境请修改对应的logback-docker.yml环境配置文件)

  3. 根据需要,修改yami-shop-multishopyami-shop-platformyami-shop-api 下的\src\main\resources\application-prod.yml线程数量(如果是 docker 环境请修改对应的application-docker.yml环境配置文件)

值得注意的是:docker环境是优先读取环境变量的,在docker-compose 文件

    environment:
      - MYSQL_HOST=mall4j-mysql
      - MYSQL_PORT=3306
      - MYSQL_DATABASE=yami_bbc
      - MYSQL_USERNAME=root
      - MYSQL_PASSWORD=hn02le.34lkdLKD
      - REDIS_HOST=mall4j-redis
      - REDIS_PORT=6379
      - REDIS_DATABASE=1
      - REDIS_PASSWORD=hn02le.34lkdLKD
      - DATACENTER_ID=21
      - ELASTIC_ADDRESS=http://mall4j-elasticsearch:9200
      - ELASTIC_USERNAME=elastic
      - ELASTIC_PASSWORD=hn02le.34lkdLKD
      - WUKONGIM_ADDRESS=http://mall4j-wukongim:5001
      - WUKONGIM_TOKEN=hn02le.34lkdLKD
      - SMS_SUPPLIER=alibaba # 默认阿里云
      - SMS_ACCESS_KEY_ID=必填短信服务accessKeyId
      - SMS_ACCESS_KEY_SECRET=必填短信accessKeySecret
      - SMS_SIGNATURE=必填短信服务signatureId

修改好环境信息之后才可以进行打包!!!

4.使用idea对项目进行打包

使用maven进行项目构建可以使用maven build相关命令,也可以直接在idea右侧 单击maven,点击clean,再点击package

maven build

  1. 修改完毕后打包,使用mvn clean package -DskipTests 命令进行打包,最终会生成很多的jar,我们需要其中三个。
  • 商城后台商家端接口 yami-shop-multishop\target\yami-shop-multishop-0.0.1-SNAPSHOT.jar
  • 商城后台平台端接口 yami-shop-platform\target\yami-shop-platform-0.0.1-SNAPSHOT.jar
  • 商城前端接口yami-shop-api\target\yami-shop-api-0.0.1-SNAPSHOT.jar
  1. 将三个jar上传到生产环境的服务器中

5. 启动

5.1不使用docker进行部署

强烈建议使用docker进行部署,因为docker可以将jdk进行隔离,而且docker里面的jdk已经在dockerfile写好了,如果不使用docker,而是自己找的jdk,会有各种各样的问题

如果步骤” 配置环境信息准备开始打包“ 中修改了PROJECT_PATH 那么对应的路径也要跟着修改

  1. 创建存放项目jar的文件夹和日志文件的文件夹

    mkdir -p /opt/projects/yami-b2b2c/log
    
  2. 将3个jar上传至 /opt/projects/yami-b2b2c 目录中

  3. 启动jar

    # 启动api,1g内存,可以根据服务器内存调整大小,推荐最低1G
    java -jar -Xmx1024m -Xss256k -Dspring.profiles.active=prod /opt/projects/yami-b2b2c/yami-shop-api-0.0.1-SNAPSHOT.jar > "/opt/projects/yami-b2b2c/log/api-console.log" &
    
    # 启动商家端,512M内存,可以根据服务器内存调整大小,推荐最低512M
    java -jar -Xmx512m -Xss256k -Dspring.profiles.active=prod /opt/projects/yami-b2b2c/yami-shop-multishop-0.0.1-SNAPSHOT.jar > "/opt/projects/yami-b2b2c/log/multishop-console.log" &
    
    # 启动平台端服务,512M内存,可以根据服务器内存调整大小,推荐最低512M
    java -jar -Xmx512m -Xss256k -Dspring.profiles.active=prod /opt/projects/yami-b2b2c/yami-shop-platform-0.0.1-SNAPSHOT.jar > "/opt/projects/yami-b2b2c/log/platform-console.log" &
    

不使用docker部署,需要将xxl-job也打包上传到服务器,同时启动

5.2使用docker进行部署

在本文件所在的目录下有个yami-shop 文件夹,压缩,上传到linux,解压

  1. 如果数据库没有初始化,在mall4j-bbc项目的db 文件夹里面会有很多的数据库文件,将0schema.sql1yami_bbc.sql2area.sql3xxl_job.sql 上传到/mysql/initdb文件夹中。
  2. 根据需要修改my.cnf,如果是新项目,可以不用修改
  3. 将打包好3个jar包,分别放到/yami-shop/yami-shop-api,/yami-shop/yami-shop-multishop,/yami-shop/yami-shop-platform文件夹,(dockerfile一般不需要改动,除非你有特别需求),等待docker-compose 启动

6. nginx配置

nginx配置可以参考 本文件所在的目录下有个yami-shop/nginx/conf.d 文件夹,有3个配置文件,内有详细的配置文件 ,可以参考:

b2b2c-api.conf

b2b2c-multishop.conf

b2b2c-platform.conf

7. xxl-job

下载xxl-job

github下载地址:https://github.com/xuxueli/xxl-job/releases/tag/3.0.0

gitee下载地址:https://gitee.com/xuxueli0323/xxl-job

用idea打开项目,修改xxl-job-admin 模块下的properties 连接数据库,数据库的默认配置已经在商城的java项目的db文件夹3xxl_job.sql 这里有初始化的信息了,记得导入

8. WuKongIm

参考文档配置机器人安装WuKongIm

9. redis容器 和 aof-redis容器的区别

redis: 商城数据、登录(token)缓存,该redis中的数据可以随时删除。

aof-redis: 持久化redis,存储商品sku库存、订单锁定记录、退款、秒杀等数据,数据不可删除,用于提高订单性能。

这里建议用两个redis:

  1. 持久化的aof,需要参考这个 linux环境(生产环境搭建)/mall4j-shop/redis/redis.conf 里面的 appendfsync always,否则aof redis是无意义的。

  2. 只做缓存的普通redis是不需要开启这个的,而且最好不要开启,毕竟会影响性能。做库存需要持久化的需要开启这个。也就是说普通的redis只要用默认的配置就行。

  3. 如果真的用不了两个redis,一定要用同一个redis,那么这个redis要开启aof,并且分开redis的数据库,比如一个放在0,一个放在10(为什么不用1,因为怕不记得0和1了),并且千万不要删掉这里的数据。

  4. 持久化的库存如论如何都有可能认为失误,或者极小概率会丢失,可以通过定时任务找回来。因为数据库存了出入库记录,通过出入库记录可以找回来。不过如果你们代码修改多了,不确定会不会影响定时任务,所以做aof是非常有必要的。

  5. 为什么要用将库存放在redis当中,因为下单的时候,提交订单会涉及很多表操作,会变成一个大事务,而库存是行锁,严重的时候对同一个商品(不是下单,同时购买同一个商品)可能每秒只能十几的并发,所以放在redis是有必要的。

订单号

如果测试环境、开发环境、生产环境用的都是同一套支付系统,那么会面临一个问题:

测试环境中的支付单号1,会与生产环境中的支付单号1重复。所以需要在不同的环境增加一个需要,比如加多个序号测试环境的1会变成11,开发环境的1会变成21

需要在application.yml 修改这个配置,请配置10-99。请手动在不同的环境加上不同的id

application:
   workerId: 21

关于跨域

关于跨域,目前已经在java后台实现了跨域的配置,修改CorsConfig 将里面*的域名改为自己需要的域名即可。

异常通知

如果希望系统报错的时候能够及时查到通知,而不是自己慢慢查询日志。可以配置异常通知的邮箱。

可以参考:https://jingyan.baidu.com/article/fedf0737af2b4035ac8977ea.html 获取授权码

spring:
  mail:
    # 企微邮箱为:smtp.exmail.qq.com,qq邮箱为:smtp.qq.com,163邮箱为:smtp.163.com,其他的请自行查找相关资料
    host: smtp.exmail.qq.com
    # 进行发送通知的邮箱账户名
    username:
    # 进行发送通知的邮箱密码,这个不是密码,而是自己邮箱-账户-开启POP3/SMTP时的客户端授权码
    password:
logging:
  # 接受异常通知的邮箱,可以配置多个用逗号隔开
  log-error-email:
  # 当前环境,比如测试环境,生产环境
  log-env: