开源地址： Github | Gitee

博客主页： https://www.cnblogs.com/haoxianrui

开发者文档：http://youlaitech.gitee.io/youlai-mall

📚️项目介绍

项目简介

youlai-mall 是基于Spring Boot 2.6、Spring Cloud 2021 & Alibaba 2021、Vue3、Element-Plus、uni-app等主流技术栈构建的一整套全栈开源商城项目， 涉及 后端微服务 、 前端管理 、 微信小程序 和 APP应用 等多端的开发。

项目特色

• 项目使用皆是当前主流的技术栈，无过度自定义封装，易理解学习和二次扩展；
• SpringBoot 2.6、SpringCloud 2021 & Alibaba 2021 一站式微服务开箱即用的解决方案；
• Spring Security OAuth2 、 Spring Cloud Gateway 、 JWT 统一认证鉴权和常用 OAuth2 授权模式扩展；
• 移动端采用终极跨平台解决方案 uni-app， 一套代码编译iOS、Android、H5和小程序等多个平台；
• Jenkins、K8s、Docker实现微服务持续集成与交付(CI/CD)。

在线预览

	地址
管理前端 Vue3	www.youlai.tech
管理前端 Vue2	www.youlai.tech:9527
H5 移动端	www.youlai.tech:81

预览截图

「App」Spring Security OAuth2 手机短信验证码模式	「小程序」Spring Security OAuth2 微信授权模式
「管理前端」Spring Security OAuth2 密码模式	「管理前端」Spring Security OAuth2 验证码模式

🪐 源码地址

名称	Gitee	Github
开源组织	有来开源组织	有来开源组织
后端	youlai-mall	youlai-mall
管理前端	mall-admin-web	mall-admin-web
小程序/H5/移动端	mall-app	mall-app

🚤 项目启动

后端启动

极速启动 是方便快速启动查看效果的启动方式，其中的数据库和Redis等中间件使用的是有来提供的云环境，切勿修改数据，有时间条件建议本地启动。

极速启动

1. 启动 Nacos

   IDEA 打开命令行终端 Terminal，输入 cd middleware/nacos/bin 切换到 Nacos 的 bin 目录，执行 startup -m standalone 启动 Nacos 服务。

2. 导入Nacos配置

   打开浏览器，地址栏输入 Nacos 管控台的地址 http://localhost:8848/nacos ；

   输入用户名/密码：nacos/nacos ；

   进入管控台，点击左侧菜单 配置管理 → 配置列表 进入列表页面，点击 导入配置 选择项目中的 doc/nacos/DEFAULT_GROUP.zip 文件 。

3. 服务启动

   进入 youlai-gateway 模块的启动类 GatewayApplication 启动网关；

   进入 youlai-auth 模块的启动类 AuthApplication 启动认证授权中心；

   进入 youlai-admin → admin-boot 模块的启动类 AdminApplication 启动系统服务；

   至此已完成基础服务的启动，商城服务按需启动，启动方式和 youlai-admin 一致。

4. 启动测试

   访问接口文档地址测试 http://localhost:9999/doc.html

本地启动

1. 中间件安装(🔴必装 ⚪可选)

   • 🔴MySQL 安装
   • 🔴Redis 安装
   • ⚪RabbitMQ
   • ⚪Seata 安装
   • ⚪Sentinel 安装

2. 数据库创建和数据初始化

   • 系统数据库

     进入 doc/sql 目录 ， 根据 MySQL 版本选择对应的脚本；

     先执行 database.sql 完成数据库的创建；

     再执行 youlai.sql 、mall_*.sql 完成数据表的创建和数据初始化。

   • Nacos数据库

     创建名为 nacos 的数据库；

     执行 middleware/nacos/conf/nacos-mysql.sql 脚本完成 Nacos 数据库初始化。

3. Nacos 配置和启动

   a. Nacos 配置持久化至 MySQL > Nacos 默认配置持久化到内嵌的Derby数据库，开发无特殊情况可使用默认配置，如需持久化配置到MySQL，完成下面配置修改即可。

   进入 `middleware/nacos/conf/application.properties` 文件修改 Nacos 配置的数据连接，需要修改配置如下：
   ```properties
   spring.datasource.platform=mysql
   db.num=1
   db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
   db.user.0=root
   db.password.0=123456
   

   b. 启动Nacos

   IDEA 打开命令行终端 Terminal，输入 `cd middleware/nacos/bin` 切换到 Nacos 的 bin 目录，执行 `startup -m standalone` 启动 Nacos 服务。
   

   c. 导入Nacos配置

   打开浏览器，地址栏输入 Nacos 管控台的地址 [ http://localhost:8848/nacos]( http://localhost:8848/nacos) ；
   
   输入用户名/密码：nacos/nacos ；
   
   进入管控台，点击左侧菜单 `配置管理` → `配置列表` 进入列表页面，点击 `导入配置` 选择项目中的 `doc/nacos/DEFAULT_GROUP.zip` 文件 ；
   

   d. 修改Nacos配置

   进入共享配置 `youlai-common.yaml` ，修改 MySQL、Redis、RabbitMQ等中间件信息为您自己本地环境，默认为有来云环境。
   

4. 服务启动

   进入 youlai-gateway 模块的启动类 GatewayApplication 启动网关；

   进入 youlai-auth 模块的启动类 AuthApplication 启动认证授权中心；

   进入 youlai-admin → admin-boot 模块的启动类 AdminApplication 启动系统服务；

   至此已完成基础服务的启动，商城服务按需启动，启动方式和 youlai-admin 一致。

5. 启动测试

   访问接口文档地址测试 http://localhost:9999/doc.html

管理前端启动

1. 本机安装 Node 环境
2. npm install
3. npm run dev
4. 访问 http://localhost:9527

微信小程序启动

1. 下载 HBuilder X 和 微信开发者工具 ;
2. 导入 mall-app 源码至 HBuilder X ;
3. 微信公众平台申请小程序，获得小程序的AppID ;
4. 微信开发者工具 微信扫码登录，开启服务端口，点击工具栏 设置 -> 安全设置 -> 安全 -> 服务端口选择打开 ;
5. Hbuilder X 替换项目AppID成自己的，点击 manifest.json 文件->微信小程序配置 ;
6. Nacos控制台替换 youlai-auth 配置中的微信小程序 AppID 和 AppSecret 为自己申请的小程序 ;
7. Hbuilder X 工具栏点击 运行 -> 运行到小程序模拟器 -> 微信开发者工具。

H5/移动端启动

1. 下载 HBuilder X ;
2. 导入 mall-app 源码至 HBuilder X;
3. Hbuilder X 工具栏点击 运行 -> 运行到内置浏览器 。

💹 趋势统计

Gitee

Github

🚀 联系信息

欢迎添加开发者微信，备注「有来」进群