高并发本地生活服务平台

本项目基于黑马点评课程项目进行学习与二次整理，主要用于展示 Redis 高并发场景下的缓存、秒杀、分布式锁、消息队列等后端能力。

项目简介

黑马点评是一个类似大众点评的本地生活服务后端项目，围绕用户登录、商户查询、优惠券秒杀、探店笔记、点赞排行、好友关注、附近商户、用户签到等业务展开。

项目重点不在页面展示，而在后端高并发场景的处理：使用 Redis 承载登录态、缓存热点数据、完成秒杀资格预检，并结合 Lua、RabbitMQ、Redisson、MyBatis-Plus 等组件解决缓存一致性、超卖、一人一单、异步下单等问题。

技术栈

分类	技术
后端框架	Spring Boot 2.3.12.RELEASE
数据访问	MyBatis-Plus, MySQL
缓存与分布式能力	Redis, Redisson, Lua
消息队列	RabbitMQ
工具库	Lombok, Hutool
构建工具	Maven
JDK	Java 8

核心功能

• 短信验证码登录：使用 Redis 保存验证码和用户登录态，用 Token 替代 Session。
• 登录拦截：通过两层拦截器完成 Token 刷新、用户信息保存、登录权限校验。
• 商户缓存：实现商户详情缓存，降低数据库访问压力。
• 缓存问题处理：包含缓存穿透、缓存击穿、缓存雪崩的处理思路和实现。
• 优惠券秒杀：使用 Redis + Lua 做库存和一人一单资格预检。
• 异步下单：秒杀请求通过 RabbitMQ 异步落库，削峰填谷。
• 分布式锁：使用 Redisson 处理集群环境下的一人一单并发问题。
• 附近商户：使用 Redis GEO 查询附近商户并按距离排序。
• 探店互动：支持探店笔记、点赞、点赞排行、关注、共同关注。
• 用户签到：使用 Redis Bitmap 记录签到并统计连续签到天数。

架构流程

登录流程

sequenceDiagram
    participant Client as 客户端
    participant API as Spring Boot
    participant Redis as Redis
    participant DB as MySQL

    Client->>API: 发送手机号获取验证码
    API->>Redis: 保存验证码，设置过期时间
    API-->>Client: 返回发送结果
    Client->>API: 手机号 + 验证码登录
    API->>Redis: 校验验证码
    API->>DB: 查询或创建用户
    API->>Redis: 保存用户信息，生成 Token
    API-->>Client: 返回 Token

Loading

秒杀下单流程

flowchart TD
    A["用户提交秒杀请求"] --> B["Redis + Lua 原子预检"]
    B --> C{"是否通过"}
    C -->|库存不足| D["返回失败"]
    C -->|重复下单| E["返回失败"]
    C -->|通过| F["生成订单号"]
    F --> G["发送消息到 RabbitMQ"]
    G --> H["消费者异步创建订单"]
    H --> I["Redisson 锁校验一人一单"]
    I --> J["扣减数据库库存并保存订单"]

Loading

项目结构

src/main/java/com/hmdp
├── config          # Web、MyBatis、RabbitMQ、Redisson 配置
├── controller      # 接口层
├── dto             # 接口返回与请求对象
├── entity          # 数据库实体
├── interceptor     # 登录拦截器
├── listener        # RabbitMQ 消费者
├── mapper          # MyBatis-Plus Mapper
├── service         # 业务接口
├── service/impl    # 业务实现
└── utils           # Redis、缓存、分布式锁等工具类

src/main/resources
├── application.yaml
├── db/hmdp.sql
├── mapper/VoucherMapper.xml
├── seckill.lua
└── unLock.lua

运行环境

建议本地准备以下环境：

• JDK 8
• Maven 3.6+
• MySQL 5.7 或 8.x
• Redis 5+
• RabbitMQ 3.x

本地启动

1. 创建数据库并导入 SQL。

CREATE DATABASE hmdp DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
USE hmdp;
SOURCE src/main/resources/db/hmdp.sql;

也可以使用 Navicat、DataGrip 等工具直接导入：

src/main/resources/db/hmdp.sql

2. 修改本地配置。

配置文件位置：

src/main/resources/application.yaml

重点确认以下配置和本地环境一致：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/hmdp?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    username: root
    password: 你的本地 MySQL 密码

  redis:
    host: 127.0.0.1
    port: 6379

  rabbitmq:
    host: localhost
    port: 5672
    username: guest
    password: guest

3. 启动依赖服务。

需要先启动 MySQL、Redis、RabbitMQ，再启动 Spring Boot 项目。

4. 启动后端服务。

mvn spring-boot:run

默认端口：

http://localhost:8081

常用接口

功能	方法	路径
发送验证码	POST	/user/code
登录	POST	/user/login
当前用户	GET	/user/me
用户签到	POST	/user/sign
连续签到统计	GET	/user/sign/count
商户详情	GET	/shop/{id}
按类型查询商户	GET	/shop/of/type
新增优惠券	POST	/voucher
新增秒杀券	POST	/voucher/seckill
秒杀下单	POST	/voucher-order/seckill/{id}
发布探店笔记	POST	/blog
点赞探店笔记	PUT	/blog/like/{id}
热门笔记	GET	/blog/hot
关注用户	PUT	/follow/{id}/{isFollow}
共同关注	GET	/follow/common/{id}

登录后访问需要权限的接口时，请在请求头中携带 Token：

authorization: 登录接口返回的 token

Redis 设计要点

场景	Redis 数据结构 / 技术点
验证码	String，短 TTL
登录态	Hash，Token 作为 Key
商户缓存	String + JSON
缓存击穿	互斥锁、逻辑过期
秒杀资格预检	Lua 脚本保证原子性
一人一单	Set 记录用户下单资格
点赞排行	ZSet
好友关注	Set
附近商户	GEO
用户签到	Bitmap
全局 ID	Redis 自增序列

说明

本项目用于学习和简历展示，重点展示 Redis 在高并发业务中的应用。