Shopizer 电商系统快速搭建指南：5步完成全栈部署
项目地址: https://gitcode.com/gh_mirrors/sh/shopizer Shopizer 是一款功能强大的开源电商系统，支持多店铺、多语言与多货币，基于Java + Spring Boot + React 技术栈构建。本指南将带你从零开始，在本地环境中快速搭建 Shopizer 全栈应用，涵盖后端、管理后台与前端商店的配置与启动。
1. 项目概览与架构解析
Shopizer 采用模块化设计，主要由三个核心组件构成：
| 组件模块 | 技术栈 | 主要功能 |
|---|---|---|
| sm-shop（后端API） | Java + Spring Boot | 提供RESTful API，处理业务逻辑 |
| shopizer-admin（管理后台） | Angular | 商品管理、订单处理等后台操作 |
| shopizer-shop-reactjs（前端商城） | React | 面向客户的电商商城界面 |
整个系统采用前后端分离架构，后端提供统一的API接口，前端和管理后台分别独立部署，便于扩展和维护。
2. 环境准备与依赖安装
在开始部署前，请确保你的系统已安装以下环境：
- JDK 11+：Java开发环境
- Maven 3.6+：项目构建工具
- Node.js 14+：前端开发环境
- MySQL 5.7+ 或 PostgreSQL：数据库
3. 获取项目源码
首先需要获取项目源码：
git clone https://gitcode.com/gh_mirrors/sh/shopizer
4. 后端服务启动步骤
一键启动后端服务
进入项目根目录，执行以下命令：
cd shopizer
mvnw clean install
cd sm-shop
mvnw spring-boot:run
执行成功后，你将看到类似以下的启动日志：
此时后端服务已在 http://localhost:8080 启动，可以通过访问 http://localhost:8080/swagger-ui.html 查看API文档。
5. 管理后台配置与运行
快速配置管理后台
管理后台基于Angular构建，需要单独部署：
# 进入管理后台目录
cd shopizer-admin
# 安装依赖并启动
npm install
npm start
常见配置项包括：
- 数据库连接配置
- 邮件服务器设置
- 文件存储路径配置
6. 前端商城部署与访问
启动React商城应用
进入前端商城目录：
cd shopizer-shop-reactjs
npm install
npm start
前端应用支持热加载，修改代码后会自动刷新，便于开发调试。
7. 关键配置文件说明
后端配置文件
主要配置文件位于 sm-shop/src/main/resources/application.properties，包含以下重要配置：
# 数据库连接
spring.datasource.url=jdbc:mysql://localhost:3306/shopizer
spring.datasource.username=root
spring.datasource.password=your_password
# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
# 邮件服务器配置
email.host=smtp.gmail.com
email.port=587
email.username=your_email@gmail.com
email.password=your_app_password
管理后台配置
管理后台的配置文件通常位于 shopizer-admin/src/environments/ 目录下，包含API端点配置等。
8. 常见问题与解决方案
端口冲突问题
如果8080端口被占用，可以在 application.properties 中修改：
server.port=8081
数据库连接失败
确保数据库服务已启动，并检查连接字符串中的主机名、端口号和认证信息。
9. 系统访问与验证
部署完成后，可以通过以下地址访问各组件：
- 后端API文档：http://localhost:8080/swagger-ui.html
- 管理后台：http://localhost:4200（默认）
- 前端商城：http://localhost:3000（默认）
建议按照以下顺序验证系统功能：
- 确认后端API服务正常响应
- 登录管理后台，测试商品管理功能
- 访问前端商城，验证购物流程
通过本指南，你已经成功搭建了Shopizer电商系统的全栈环境。系统支持多店铺管理、商品分类、订单处理等完整电商功能，可根据实际需求进行定制开发。
对于更详细的配置说明和高级功能，建议查阅项目中的官方文档，其中包含了完整的API参考和配置选项说明。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
