🎉前言

项目命名为goodsKill一方面有商品秒杀项目的意思(好像有点chinglish的味道)，另外也可理解为good skill，本项目就是希望搭建一套完整的项目框架，把一些好的技术和技巧整合进来（偏向于后端技术），方便学习和查阅。

本项目为慕课网仿购物秒杀网站,系统分为用户注册登录、秒杀商品管理模块。注册登录功能目前使用shiro完成权限验证，支持OAuth2.0第三方授权登录（目前可通过Gitee，Github进行授权）。 此项目整体采用springMVC+RESTFUL风格，mybatis持久层框架，采用springcloud dubbo实现服务分布式服务调用，服务注册发现使用nacos server。

本项目扩展了秒杀功能，集成了jmock完成service层的测试，支持数据库分库分表，并提供基本的秒杀解决方案（通过模拟接口实现）。

• 集成内嵌式H2数据库，方便独立进行单元功能测试

• 集成sentinel限流组件，可以针对http请求以及dubbo rpc调用限流

• 集成新版支付宝easySDK，通过当面扫完成扫码付款

• 集成服务网关，采用Spring Cloud Gateway网关组件，并提供JWT用户鉴权功能

💎分支介绍

dev_gradle分支为使用gradle构建工具管理项目依赖（已停更），dev_maven分支对应maven构建工具（springframework版本4.x，已停更），master分支基于最新springcloud体系构建。本项目功能目前比较简陋且有很多不完善的地方，仅作学习参考之用，如果觉得本项目对你有帮助的请多多star支持一下👍~~~~。

附：码云项目链接https://gitee.com/techa/goodsKill ,clone速度慢的用码云仓库拉吧，不定期同步到码云~

✨技术选型

📌后端技术:

📌前端技术:

📝项目模块介绍

goodsKill
|--goodskill-admin                          ||SpringBoot Admin监控服务端，支持Spring Cloud微服务发现
|--goodskill-chat-provider                  ||聊天室服务提供者（待完成）
|--goodsKill-common                         ||项目公共服务（待补充）
|--goodskill-gateway                        ||微服务网关
|--goodsKill-es-provider                    ||elasticsearch搜索服务提供者，提供商品名称检索功能
|   |--goodskill-es-api                     
|   |--goodskill-es-dao                     
|   |--goodskill-es-service                 
|--goodsKill-mongo-provider                 ||mongo存储服务提供者
|   |--goodskill-mongo-service              
|--goodsKill-spring-boot-provider           ||订单、用户、登录、商品管理服务提供者（待拆分）
|   |--goodsKill-api                        ||提供服务API接口
|   |--goodsKill-mp-dao                     ||数据库访问  
|   |--goodsKill-entry                      ||实体类
|   |--goodsKill-generator                  ||项目代码生成
|   |--goodsKill-service                    ||服务API接口实现
|   |--goodsKill-util                       ||工具类
|--goodskill-spring-boot-starter            ||项目配置自动装配
|--goodskill-web                            ||提供页面客户端访问，controller层在这一模块   
|--goodskill-job                            ||elastic-job定时任务 
|--goodskill-seata                          ||集成nacos+dubbo+shardingjdbc+seata的分布式事务解决方案示例
|--goodskill-oauth2                         ||oauth2.0自定义模块
    |--oauth2-auth-server                   ||oauth2.0登录授权服务端，自定义的授权登录服务
    |--oauth2-resource-server               ||oauth2.0资源服务端，自定义的授权登录服务

🧰开发环境版本说明

• JDK: OpenJDK11
• MySQL: 8.0.21+
• Kafka: 2.7.0+
• MongoDB: 4.4+
• Elasticsearch: 7.10.1+
• Sharding-JDBC: 4.1.1
• RabbitMQ: 3.8.5+
• SpringCloud: 2020.0.x
• SpringBoot: 2.5.x
• SpringCloudAlibaba: 2021.x
• Kotlin: 1.5.x
• NacosServer: 1.4.1
• SeataServer: 1.4.1

🕹️️如何启动项目

方法一：使用Docker镜像构建脚本

• 项目根目录goodsKill中执行

  mvn clean install
  或 
  #跳过单元测试
  mvn clean install -DskipTests
  

• 进入项目根目录(确保已安装compose以支持docker-compose命令)，执行以下命令：

  docker-compose up （第一次运行只需执行此命令）
  or
  docker-compose up -d //-d后台运行
  or
  docker-compose up -d --build //build重新构建镜像文件，针对项目自定义镜像配置需要修改的情况
  or
  docker-compose up -d --no-recreate //如上次以构建容器，则此次会跳过构建容器
  

  注:推荐使用docker-compose命令（推荐电脑运行内存16G以上），无需手动下载软件安装包，开箱即用。此命令会自动拉取docker镜像并以默认端口运行

  镜像	版本	端口	用户名密码
  Nacos	1.4.1	8848	无
  Redis	latest	6379	无
  Kafka	2.13-2.7.0	9092	无
  KafkaManager	latest	9000	无
  Mongo	4.4.3	27017	无
  MySQL	8.0.22	3306	root:Password123
  Zookeeper	3.6.2	2181	无
  Elasticsearch	7.10.1	9200 9300	无
  Kibana	7.10.1	5601	无
  RabbitMQ	latest	5672 15672	无
  Zipkin	latest	9411	无

注:除以上镜像外，docker-compose.yml文件还包含项目构建命令，目前暂未列出。 若仅启动以上镜像不启动项目应用，可使用以下命令：

docker-compose -f goodskill-simple.yml up -d

⚠导入项目数据库基础数据 ️

• 找到seckill.sql文件，在本地mysql数据库中建立seckill仓库并执行完成数据初始化操作

  注:docker-compose启动方式会自动执行初始化脚本，因此无需执行该步骤

• 启动完成后访问登录页面http://www.goodskill.com:8080/goodskill/web/login，默认管理员账号admin123，密码：aa123456

方法二：使用IDEA运行项目

• 如无docker运行环境，可参照官网安装上述应用，本地默认端口启动

• 进入goodskill-gateway模块，通过GatewayApplication类main方法启动服务网关

• 找到EsApplication类main方法启动远程服务

• 找到GoodsKillServiceApplication类main方法启动远程服务，并且需要在host中加入以下信息

  127.0.0.1       kafka
  127.0.0.1       nacos
  127.0.0.1       redis
  127.0.0.1       mysql
  127.0.0.1       zookeeper
  127.0.0.1       mongo
  127.0.0.1       elasticsearch
  127.0.0.1       rabbitmq
  127.0.0.1       zipkin
  ##如果网关服务部署在远程机器，此处改为相应的远程机器ip
  127.0.0.1       www.goodskill.com
  

• 进入goodsKill-web模块根目录，运行命令或直接通过SampleWebJspApplication类main方法启动

  mvn spring-boot:run -Dspring.profiles.active=docker
  

• 如已安装MongoDB，可以main方法启动MongoReactiveApplication，通过使用该服务操作mongo库

运行项目最低要求

1. 启动nacos、redis、mysql、rabbitmq、kafka、zookeeper
2. 参考上一节配置host
3. main方法运行GatewayApplication类
4. main方法运行GoodsKillServiceApplication类
5. main方法运行SampleWebJspApplication类

如何使用本项目自定义的OAuth2.0授权服务器进行登录授权

• 待完善。。

额外功能（可选）

• 已集成sentinel限流组件，支持nacos配置中心方式推送限流规则，使用时需启动sentinel控制台，并以18088端口启动，docker环境暂不支持。
• 通过main方法启动GoodskillSeataApplication运行seata示例，运行前需启动seata-server服务，并配置nacos为seata注册中心和配置中心，另外还需在nacos控制台中增加以下配置（group需配置为SEATA_GROUP）

  service.vgroupMapping.my_test_tx_group=default
  store.mode=file
  

  可参考Seata官方Nacos配置文档:http://seata.io/zh-cn/docs/user/configuration/nacos.html

📦打包部署方法

• 可参考Dockerfile文件，如:

FROM openjdk:11.0.9.1-jdk
COPY goodsKill-service/target/goodsKill-service.jar /app/goodsKill-service.jar
WORKDIR /app
CMD ["java", "-jar","-Dspring.profiles.active=docker","-Duser.timezone=GMT+08", "goodsKill-service.jar"]

❓常见问题

• 使用idea启动SampleWebJspApplication类(goodsKill-web模块)时会出现访问不了页面的问题，eclipse无此问题。

  解决办法：配置启动类的工作目录为goodsKill-web

• docker es镜像启动失败？

  出现此问题一般为linux环境，运行以下命令即可

  sysctl -w vm.max_map_count=262144
  

  或者修改/etc/sysctl.conf文件，追加以下配置：

  grep vm.max_map_count /etc/sysctl.conf
  vm.max_map_count=262144
  

• 新版支付宝SDK已集成，使用时需将AlipayRunner中的alipay对应配置替换成你的支付宝应用配置（本项目基于沙箱环境）

    //为了防止启动项目报错默认配置为1，可参考官方文档修改对应配置
    @Value("${alipay.merchantPrivateKey:1}")
    private String merchantPrivateKey;

    @Value("${alipay.alipayPublicKey:1}")
    private String alipayPublicKey;
    
    ......   

📚分库分表情况说明

注:其他表均未分库分表，默认使用seckill作为主库

🔖服务网关说明

• http://www.goodskill.com/goodskill/mongo 对应goodsKill-mongo-provider服务

• http://www.goodskill.com/goodskill/es 对应goodsKill-es-provider服务

• http://www.goodskill.com/goodskill/seata 对应goodskill-seata服务

• http://www.goodskill.com/goodskill/common 对应goodsKill-service-provider服务

• 通过http://www.goodskill.com/goodskill/common/token接口获取token

• 通过http://www.goodskill.com/goodskill/common/refresh刷新用户token

🔥🔥秒杀方案

目前实现了几种秒杀方案，通过SeckillMockController提供测试接口

swagger主页测试地址: http://www.goodskill.com:8080/goodskill/web/swagger-ui/index.html

SpringBoot Admin应用监控地址: http://www.goodskill.com:8083, 登录用户名密码：admin/123456

kafka状态监控页面地址: http://localhost:9000

zipkin链路跟踪页面地址: http://localhost:9411/zipkin/

• 场景一：sychronized同步锁实现
• 场景二：redisson分布式锁实现
• 场景三：ActiveMQ实现(已废弃)
• 场景四：Kafka消息队列实现
• 场景五：数据库原子性更新
• 场景六：实时等待秒杀处理结果(已废弃)
• 场景七：zookeeper分布式锁
• 场景八：使用redis进行秒杀商品减库存操作，秒杀结束后异步发送MQ，使用mongoDB完成数据落地
• 场景九：SpringCloudStream RabbitMQ实现
• 场景十：Sentinel限流+数据库原子性更新（需搭配sentinel控制台配置资源名limit的流控规则）

可在web控台查看秒杀结果，打印信息类似：

2021-04-14 21:58:59.857  INFO [goodskill-web,df43cc8f59291c48,df43cc8f59291c48] 15808 --- [           main] o.s.w.controller.SeckillMockController   : 秒杀场景二(redis分布式锁实现)开始时间：Wed Apr 14 21:58:59 CST 2021,秒杀id：1000
2021-04-14 21:59:00.094  INFO [goodskill-web,144aa7910cca9520,2821cb8d62c5a908] 15808 --- [AClOSzbugzYng-1] o.s.w.s.c.SeckillMockResponseListener    : 秒杀活动结束，秒杀场景二(redis分布式锁实现)时间：Wed Apr 14 21:59:00 CST 2021,秒杀id：1000
2021-04-14 21:59:00.101  INFO [goodskill-web,144aa7910cca9520,2821cb8d62c5a908] 15808 --- [AClOSzbugzYng-1] o.s.w.s.c.SeckillMockResponseListener    : 最终成功交易笔数统计中。。。
2021-04-14 21:59:01.616  INFO [goodskill-web,144aa7910cca9520,2821cb8d62c5a908] 15808 --- [AClOSzbugzYng-1] o.s.w.s.c.SeckillMockResponseListener    : 最终成功交易笔数统计中。。。
2021-04-14 21:59:03.129  INFO [goodskill-web,144aa7910cca9520,2821cb8d62c5a908] 15808 --- [AClOSzbugzYng-1] o.s.w.s.c.SeckillMockResponseListener    : 最终成功交易笔数：10
2021-04-14 21:59:03.130  INFO [goodskill-web,144aa7910cca9520,2821cb8d62c5a908] 15808 --- [AClOSzbugzYng-1] o.s.w.s.c.SeckillMockResponseListener    : 历史任务耗时统计：StopWatch '': running time = 36159894800 ns
---------------------------------------------
ns         %     Task name
---------------------------------------------
4492195700  012%  秒杀场景四(kafka消息队列实现)
3164155900  009%  秒杀场景八(秒杀商品存放redis减库存，异步发送秒杀成功MQ，mongoDb数据落地)
6219218300  017%  秒杀场景十(Sentinel限流+数据库原子性更新)
9189080600  025%  秒杀场景七(zookeeper分布式锁)
3135926500  009%  秒杀场景五(数据库原子性更新update set num = num -1)
3342791800  009%  秒杀场景九(基于springcloud stream rabbitmq)
3343433700  009%  秒杀场景一(sychronized同步锁实现)
3273092300  009%  秒杀场景二(redis分布式锁实现)

🔨后续更新计划

API接口

API接口说明

💻页面展示

登录

注册

主页

商品查询

搜索框下拉商品候选信息基于elasticsearch实现，支持关键词高亮显示

用户角色权限管理

商品列表限流

Kafka状态监控

模拟秒杀接口测试

📑数据库表结构

📖参考文档

• 解决Docker容器连接 Kafka 连接失败问题：https://www.cnblogs.com/hellxz/p/why_cnnect_to_kafka_always_failure.html