从零到一：我的首个开源商城项目litemall部署实战

1. 环境准备：从零搭建开发环境

第一次部署开源项目就像组装一台新电脑，所有零件都要自己动手安装。记得我刚开始接触litemall商城项目时，光是环境配置就折腾了两天。这里分享下我的踩坑经验，帮你少走弯路。

1.1 基础软件安装清单

开发环境就像厨房里的锅碗瓢盆，缺一不可。我整理了一份必备工具清单：

• Java开发套件：推荐JDK 8（别用太新的版本，容易出兼容性问题）
• MySQL数据库：5.7版本最稳定（记得配置好root密码）
• Node.js环境：建议安装LTS版本（我当时装最新版结果npm报错）
• Maven工具：项目管理必备（配置好本地仓库路径）
• Git版本控制：代码下载和版本管理的基础工具

安装过程有个小技巧：所有路径都不要用中文和空格。我第一次安装时用了"程序文件"目录，结果Maven死活找不到依赖包。

1.2 开发工具选择

IDE就像程序员的武器，选对工具事半功倍。我对比过几款主流工具：

• IntelliJ IDEA：Java开发神器（社区版就够用）
• VS Code：轻量级前端开发利器
• SQLyog：比Navicat更轻量的MySQL客户端

特别提醒：安装IDEA后记得配置Maven路径。我刚开始直接用了默认配置，结果每次编译都要下载依赖，等得怀疑人生。后来在设置里把Maven改为本地安装的版本，速度直接起飞。

2. 项目获取与初始化

拿到项目代码就像收到乐高积木，关键是要把所有零件正确组装。litemall的代码托管在国内的码云平台，下载速度比GitHub快很多。

2.1 克隆项目代码

在合适目录右键选择"Git Bash Here"，执行：

bash复制git clone https://gitee.com/linlinjava/litemall.git

如果遇到网络问题，可以试试这个镜像命令：

bash复制git clone https://gitee.com/linlinjava/litemall.git --depth=1

加上--depth=1参数只克隆最新版本，能节省不少时间和空间。

2.2 数据库初始化

数据库是商城的"记忆中枢"，初始化时要特别注意顺序。项目提供了三个SQL文件：

1. litemall_schema.sql：创建空数据库
2. litemall_table.sql：建表语句
3. litemall_data.sql：初始化测试数据

执行时最容易踩的坑是字符集问题。建议先用这个命令设置编码：

bash复制mysql -u root -p --default-character-set=utf8mb4 < litemall_schema.sql

记得检查数据库的排序规则是不是utf8mb4_general_ci，否则中文可能会乱码。

3. 项目编译与打包

编译过程就像把食材加工成菜品，每个步骤都有讲究。litemall采用前后端分离架构，需要分别处理。

3.1 后端Java项目编译

用IDEA打开项目后，重点关注这几个点：

1. 等待Maven自动下载依赖（第一次可能要10-20分钟）
2. 检查pom.xml有没有报错（版本冲突很常见）
3. 执行mvn clean package命令打包

我遇到最头疼的问题是Jar包冲突。有个报错提示ClassNotFoundException，最后发现是Spring Boot版本不匹配。解决方法是在pom里显式指定版本号：

xml复制<spring-boot.version>2.3.12.RELEASE</spring-boot.version>

3.2 前端项目构建

前端项目在litemall-admin目录，常见问题有：

1. 依赖安装失败：换淘宝镜像源

bash复制npm config set registry https://registry.npm.taobao.org

2. node-sass报错：指定国内镜像

bash复制npm install -g mirror-config-china --registry=https://registry.npm.taobao.org

3. 内存不足：增加Node内存限制

bash复制set NODE_OPTIONS=--max_old_space_size=4096

4. 项目启动与调试

启动阶段就像点火试车，需要监控各个系统的运行状态。

4.1 后端服务启动

在项目根目录执行：

bash复制chcp 65001
java -Dfile.encoding=UTF-8 -jar litemall-all/target/litemall-all-0.1.0-exec.jar

第一行命令是解决Windows控制台乱码问题。如果启动失败，常见原因有：

• 端口冲突（默认8080端口被占用）
• 数据库连接失败（检查application.yml配置）
• 缓存问题（尝试clean后重新打包）

4.2 前端服务启动

在admin目录下运行：

bash复制npm run dev

启动成功后访问http://localhost:9527，默认账号admin/123456。如果页面空白，可能是：

1. 接口跨域问题（检查后端地址配置）
2. 路由模式错误（修改vue.config.js）
3. 浏览器缓存（强制刷新或开无痕模式）

记得第一次登录后及时修改默认密码，安全防护要从开发阶段就开始重视。整个部署过程虽然会遇到各种问题，但每解决一个bug都是宝贵的经验积累。