litemall：开源小商城系统后端与微信小程序端搭建指南

一、项目官方信息

litemall 是又一个小商场系统，技术组成是：Spring Boot 后端 + Vue 管理员前端 + 微信小程序用户前端 + Vue 用户移动端。

功能覆盖：

• 小商城：首页、专题、分类、品牌、新品/人气、优惠券、团购、搜索、商品详情/评价/分享、购物车、下单、订单售后、地址/收藏/足迹、客服；
• 管理平台：会员、商城、商品、推广、系统、配置管理与统计报表。

警告：本项目仅用于学习练习，仍处在开发中，不承担使用后果。

二、官方图片

• 上图为 litemall 官方 README 中的技术栈图（Spring Boot + Vue + 微信小程序）。
• 另附项目架构图（project-structure）展示前后端模块划分。

三、环境要求

最小开发环境：

• MySQL；
• JDK 1.8 或以上；
• Maven；
• Node.js；
• 微信开发者工具。

四、部署步骤

1. 导入数据库

依次导入 litemall-db/sql 下的数据库文件：

• litemall_schema.sql
• litemall_table.sql
• litemall_data.sql

2. 启动后端服务

cd litemall
mvn install
mvn clean package
java -Dfile.encoding=UTF-8 -jar litemall-all/target/litemall-all-0.1.0-exec.jar

3. 启动管理后台前端

cd litemall/litemall-admin
npm install --registry=https://registry.npm.taobao.org
npm run dev

浏览器访问 http://localhost:9527 即进入管理后台登录页。

4. 启动微信小程序前端

项目里有两套小商城前端：litemall-wx 和 renard-wx，可分别导入测试：

1. 微信开发者工具导入 litemall-wx 项目；
2. 项目配置里启用「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」；
3. 点击「编译」即可在开发者工具预览；
4. 也可点「预览」用手机扫码登录（手机需开启调试）。

注意：这里只是最简启动方式；微信登录、微信支付等功能需另行配置开发者参数，详见文档。

5. 启动轻商城前端（Vue 移动端）

cd litemall/litemall-vue
npm install --registry=https://registry.npm.taobao.org
npm run dev

浏览器（建议 Chrome 手机模式）访问 http://localhost:6255 进入轻商场。（README 提示该模块当时功能不稳定，处于开发阶段。）

五、使用方法

• 管理后台（9527）：管理员登录后管理会员、商品、订单、推广与系统配置，查看统计报表。
• 小程序端（litemall-wx）：用户浏览首页、分类、商品，加购下单，在会员中心查看订单/收藏/足迹。
• 轻商城（6255）：基于 Vue 的移动端 H5 商城。

六、常见问题 FAQ

1. 后端打包失败？ 确保 JDK 1.8+、Maven 可用、MySQL 已启动且三个 SQL 文件已导入；按 README 顺序先 mvn install 再 mvn clean package。

2. 小程序编译后接口报错？ 本地调试需在开发者工具勾选「不校验合法域名…」，并确认后端 jar 已启动、数据库连接配置正确。

3. 管理后台访问哪个端口？ npm run dev 后访问 http://localhost:9527。

4. 微信登录/支付不能用？ 最简启动只跑通浏览与下单流程；微信登录、微信支付需配置小程序 AppID、商户号等，详见官方文档。

5. 有两套小程序前端？ litemall-wx 和 renard-wx 可分别导入测试；litemall-vue 是 Vue 版轻商城 H5。

6. 项目可以直接商用吗？ README 警告其仍在开发中，仅用于学习练习，商用前需自行完善与测试。

七、跳转链接

• GitHub 仓库：https://github.com/linlinjava/litemall
• 官方文档：https://linlinjava.gitbook.io/litemall
• FAQ：https://linlinjava.gitbook.io/litemall/faq