yshop-drink开源项目使用指南

准备阶段：环境与资源就绪

💡 实用提示：开始前请确保至少8GB内存和5GB可用磁盘空间，推荐使用64位操作系统以获得最佳性能。

环境检测：系统兼容性验证

⚠️ 注意事项：不同操作系统需安装对应的依赖管理工具，避免使用root用户直接操作。

环境要求	Windows	macOS	Linux
Java	JDK 17+	brew install openjdk@17	apt install openjdk-17-jdk
Node.js	v16+	brew install node@16	nvm install 16
数据库	MySQL 8.0	brew install mysql@8.0	apt install mysql-server
构建工具	Maven 3.8+	brew install maven	apt install maven

🛠️ 工具推荐：数据库管理可使用DBeaver或Navicat，代码编辑推荐VSCode配合Volar插件。

源码获取：项目克隆与目录解析

git clone https://gitcode.com/gh_mirrors/ys/yshop-drink
cd yshop-drink

项目架构采用前后端分离设计，核心目录结构如下：

yshop-drink/
├── assets/                  # 静态资源文件
├── yshop-drink-boot3/       # Java后端工程（SpringBoot3）
│   ├── yshop-server/        # 应用启动模块
│   ├── yshop-framework/     # 框架核心组件
│   └── yshop-module-*/      # 业务功能模块
├── yshop-drink-vue3/        # 管理后台前端（Vue3）
└── yshop-drink-uniapp-vue3/ # 移动端应用（UniApp）

图1：后端配置文件在项目中的位置及数据库连接参数示例

部署阶段：快速启动应用

💡 实用提示：首次部署建议先启动后端服务，再配置前端项目，可避免API连接失败问题。

后端部署：服务端启动流程

命令行方式：

# 进入后端目录
cd yshop-drink-boot3

# 编译打包（跳过测试）
mvn clean package '-Dmaven.test.skip=true'

# 启动服务
java -jar yshop-server/target/yshop-server.jar

图形界面方式：

1. 使用IntelliJ IDEA打开yshop-drink-boot3目录
2. 等待Maven依赖下载完成
3. 找到YshopServerApplication.java（位于yshop-server/src/main/java/com/ys/yshop/）
4. 右键选择Run 'YshopServerApplication'

⚠️ 注意事项：默认端口为8080，若被占用可修改application.yml中的server.port配置。

前端部署：管理后台启动

命令行方式：

# 进入前端目录
cd yshop-drink-vue3

# 安装依赖
pnpm install

# 启动开发环境
npm run dev

图形界面方式：

1. 使用VSCode打开yshop-drink-vue3目录
2. 打开终端（Ctrl+）执行pnpm install`
3. 安装完成后执行npm run dev
4. 在弹出的浏览器窗口中访问应用

移动端部署：小程序运行

图2：在HBuilder中配置小程序运行环境

微信小程序方式：

1. 使用HBuilderX导入yshop-drink-uniapp-vue3项目
2. 配置微信开发者工具路径（设置 > 运行配置 > 小程序运行配置）
3. 点击工具栏运行 > 运行到小程序模拟器 > 微信开发者工具

H5方式：

# 进入移动端目录
cd yshop-drink-uniapp-vue3

# 安装依赖
npm install

# 启动H5开发环境
npm run dev:h5

配置阶段：系统参数调优

💡 实用提示：配置修改后建议使用版本控制工具跟踪变更，便于环境迁移和回滚。

基础配置：必要参数设置

配置项	默认值	推荐值	风险等级
数据库URL	jdbc:mysql://localhost:3306/yshop_drink	按实际数据库地址修改	高
数据库用户名	root	专用数据库账号	高
数据库密码	123456	强密码（字母+数字+符号）	高
Redis地址	localhost:6379	生产环境建议使用集群	中
服务端口	8080	生产环境建议使用80/443	低

数据库连接配置文件路径：/data/web/disk1/git_repo/gh_mirrors/ys/yshop-drink/yshop-drink-boot3/yshop-server/src/main/resources/application.yml

高级配置：性能优化

JVM参数调优：

# 生产环境启动脚本示例
java -Xms2g -Xmx2g -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -jar yshop-server.jar

数据库连接池配置：

spring:
  datasource:
    hikari:
      maximum-pool-size: 20  # 默认10，高并发场景建议调整为20-50
      connection-timeout: 30000  # 连接超时时间，默认30秒
      idle-timeout: 600000  # 空闲连接超时时间，默认10分钟

常见问题：配置错误排查

问题现象	可能原因	解决方案
数据库连接失败	地址或凭据错误	检查application.yml中的数据库配置
端口占用	8080端口被其他服务占用	修改server.port或关闭占用进程
前端请求404	后端未启动或API地址错误	确认后端服务状态，检查.env.development中的VUE_APP_API_URL

扩展阶段：功能定制与维护

💡 实用提示：二次开发前建议先创建分支，遵循"功能分支-测试-合并"的开发流程。

跨平台兼容性：多环境适配

Windows环境特殊配置：

• 数据库路径配置需使用双反斜杠：C:\\ProgramData\\MySQL\\MySQL Server 8.0\\data
• Maven仓库路径默认位于：C:\\Users\\用户名\\.m2\\repository

Linux环境服务配置：

# 创建系统服务
sudo nano /etc/systemd/system/yshop.service

# 服务内容
[Unit]
Description=YShop Drink Service
After=network.target mysql.service

[Service]
User=appuser
WorkingDirectory=/data/web/disk1/git_repo/gh_mirrors/ys/yshop-drink/yshop-drink-boot3
ExecStart=/usr/bin/java -jar yshop-server/target/yshop-server.jar
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target

性能监控：关键指标跟踪

图3：管理后台订单管理界面，可监控实时交易数据

关键监控点：

1. 数据库连接数：通过SHOW PROCESSLIST命令查看
2. JVM内存使用：jstat -gcutil <PID> 1000
3. 接口响应时间：在yshop-framework中配置请求日志拦截器

故障排查：问题定位流程

1. 检查应用日志：

   • 后端日志路径：yshop-drink-boot3/yshop-server/logs/yshop.log
   • 前端控制台：F12打开开发者工具，查看Network和Console标签

2. 常见故障流程图：

   启动失败 → 检查端口占用 → 检查数据库连接 → 检查配置文件
                      ↓
                 服务启动成功
                      ↓
   功能异常 → 查看应用日志 → 检查API请求 → 数据库查询分析
   

3. 性能问题排查工具：

   • JVM分析：VisualVM
   • 数据库分析：MySQL Workbench
   • 接口测试：Postman

总结

本指南通过"准备-部署-配置-扩展"四阶段框架，帮助开发者快速掌握yshop-drink项目的使用方法。项目采用SpringBoot3+Vue3+UniApp技术栈，支持多门店和SaaS多租户模式，适合各类餐饮场景的数字化转型需求。建议定期关注项目更新，及时获取功能优化和安全补丁。