1. 项目背景与核心价值
上门维修服务行业一直面临着服务响应慢、流程不透明、管理效率低等痛点。传统电话预约方式存在信息记录不完整、工单分配不合理等问题，而现有的维修平台又往往过于复杂，用户使用门槛高。基于微信小程序的解决方案恰好能解决这些痛点——微信生态拥有12亿月活用户，无需下载安装，即用即走，特别适合这种低频但刚需的服务场景。
我在实际开发中发现，SpringBoot+微信小程序的组合具有独特优势：
- 微信小程序提供完善的用户体系、支付能力和地理位置接口
- SpringBoot后端快速构建RESTful API，与小程序前端天然契合
- Uni-app跨端框架可同时覆盖微信、支付宝等多端小程序
这个毕业设计项目实现了完整的维修服务闭环：
- 用户端：在线报修→选择维修工→支付定金→服务评价
- 维修工端：订单接收→服务确认→上传维修报告
- 管理端：数据统计→工单调度→配件库存管理
提示：系统设计时要特别注意微信生态的特殊性，比如用户登录必须走微信官方unionID机制，支付必须使用微信支付接口，消息通知要用订阅消息模板。
2. 技术架构设计解析
2.1 整体技术栈选型
前端技术矩阵：
- 微信小程序原生语法 + Uni-app跨端框架
- Vant Weapp组件库（特别适配维修行业的表单组件）
- 腾讯地图JavaScript API（实现LBS服务半径控制）
后端技术方案：
java复制// 典型Controller层结构示例
@RestController
@RequestMapping("/api/order")
public class OrderController {
@Autowired
private OrderService orderService;
@PostMapping("/create")
public Result createOrder(@RequestBody OrderDTO dto) {
return orderService.createOrder(dto);
}
}
数据库设计要点：
- 用户表：需存储微信openid和unionid
- 订单表：包含服务状态机（0待支付→1已接单→2服务中→3已完成）
- 评价表：采用星级+文字评价的复合结构
2.2 关键接口设计
维修工接单接口需要考虑并发控制：
java复制@Transactional
public Result acceptOrder(Long orderId, Long workerId) {
// 乐观锁控制并发接单
int rows = orderMapper.updateStatus(orderId, 0, 1);
if(rows == 0){
return Result.error("订单已被其他维修工接单");
}
// 记录接单关系
orderWorkerMapper.insert(new OrderWorker(orderId, workerId));
return Result.success();
}
3. 核心功能实现细节
3.1 微信登录集成方案
小程序端登录流程：
javascript复制// 小程序端登录代码
wx.login({
success: res => {
wx.request({
url: '/api/auth/login',
data: { code: res.code },
success: (res) => {
// 存储返回的token
wx.setStorageSync('token', res.data.token)
}
})
}
})
后端验证逻辑：
java复制public String wechatLogin(String code) {
// 调用微信API获取session_key
String url = "https://api.weixin.qq.com/sns/jscode2session?appid="+appid
+"&secret="+secret+"&js_code="+code+"&grant_type=authorization_code";
JSONObject sessionInfo = httpClient.get(url);
// 生成JWT token
return JWT.create()
.withClaim("openid", sessionInfo.getString("openid"))
.sign(Algorithm.HMAC256(secret));
}
3.2 维修订单状态机设计
订单状态流转规则：
| 状态码 | 状态名称 | 允许操作 |
|---|---|---|
| 0 | 待支付 | 取消订单、支付定金 |
| 1 | 待接单 | 维修工接单 |
| 2 | 服务中 | 上传维修报告 |
| 3 | 待评价 | 用户评价 |
| 4 | 已完成 | 无 |
| -1 | 已取消 | 无 |
状态变更的领域事件处理：
java复制public class OrderStatusChangeEvent {
private Long orderId;
private Integer fromStatus;
private Integer toStatus;
// 事件处理逻辑...
}
4. 典型问题解决方案
4.1 维修工抢单并发控制
采用Redis分布式锁方案：
java复制public boolean acceptOrderWithLock(Long orderId, Long workerId) {
String lockKey = "order:accept:" + orderId;
String lockValue = workerId.toString();
try {
// 获取锁（设置10秒过期）
Boolean locked = redisTemplate.opsForValue()
.setIfAbsent(lockKey, lockValue, 10, TimeUnit.SECONDS);
if(locked != null && locked){
// 执行业务逻辑
return acceptOrder(orderId, workerId).isSuccess();
}
return false;
} finally {
// 释放锁（需判断是否自己的锁）
if(lockValue.equals(redisTemplate.opsForValue().get(lockKey))){
redisTemplate.delete(lockKey);
}
}
}
4.2 微信支付与退款处理
支付流程注意事项：
- 预支付订单要设置合理的过期时间（建议2小时）
- 支付结果通知要做签名验证
- 退款需处理原路返回和余额退款两种场景
支付结果回调处理：
java复制@PostMapping("/pay/notify")
public String payNotify(HttpServletRequest request) {
// 验证签名
if(!WXPayUtil.isSignatureValid(request, apiKey)){
return "<xml><return_code>FAIL</return_code></xml>";
}
// 处理支付成功逻辑
orderService.handlePaySuccess(parseNotify(request));
return "<xml><return_code>SUCCESS</return_code></xml>";
}
5. 性能优化实践
5.1 维修工接单推荐算法
基于多因素加权评分：
java复制public List<WorkerVO> recommendWorkers(OrderDTO order) {
return workerMapper.selectNearby(order.getLat(), order.getLng())
.stream()
.map(worker -> {
WorkerVO vo = new WorkerVO(worker);
// 综合评分 = 基础分 + 距离分 + 评价分
vo.setScore(
50 +
(100 - distanceScore(worker, order)) * 0.3 +
worker.getRating() * 20
);
return vo;
})
.sorted(Comparator.comparing(WorkerVO::getScore).reversed())
.limit(5)
.collect(Collectors.toList());
}
5.2 数据库查询优化
慢查询优化案例：
sql复制-- 优化前的订单查询
SELECT * FROM orders WHERE status = 1 ORDER BY create_time DESC;
-- 优化方案：添加复合索引
ALTER TABLE orders ADD INDEX idx_status_createtime (status, create_time DESC);
-- 分页优化：使用延迟关联
SELECT * FROM orders o
JOIN (SELECT id FROM orders WHERE status = 1 ORDER BY create_time DESC LIMIT 10000, 10) t
ON o.id = t.id;
6. 部署与监控方案
6.1 小程序发布流程
必须完成的配置项：
- 小程序后台配置合法域名（API服务器地址）
- 开通微信支付商户号并绑定小程序
- 配置消息模板和订阅消息
- 设置业务域名（防止web-view劫持）
6.2 服务端监控指标
关键监控项配置示例：
yaml复制# Prometheus监控配置示例
metrics:
enabled: true
requests:
enabled: true
percentiles: [0.95, 0.99]
jvm:
memory: true
threads: true
7. 项目演进方向
在实际运营中，可以考虑以下扩展：
- 智能调度系统：结合维修工实时位置和历史完成时间预测
- AR远程指导：通过小程序相机实现远程故障诊断
- 配件电商模块：维修工可现场下单所需配件
- 保险服务集成：与第三方保险平台对接意外险服务
我在开发过程中特别深的一个体会是：微信生态的接口限制虽然多，但正是这些限制保证了用户体验的一致性。比如强制使用微信支付虽然增加了开发成本，但避免了各种支付方式的体验割裂。建议后来者在开发类似系统时，先吃透微信官方文档，特别是《小程序运营规范》和《开放接口权限说明》，可以少走很多弯路。