基于Spring Boot的校园“拼车顺路同行”平台设计与实现
1. 项目背景与意义
随着高校办学规模的扩大和校区分散布局的常态化,学生跨校区上课、实习通勤、节假日返乡等出行需求日益频繁。传统的公共交通在高峰时段运力紧张,出租车和网约车费用较高,而校园内大量私家车和教职工车辆存在空座闲置的情况。这种“有车无客、有客无车”的信息不对称,造成了交通资源的浪费。
校园“拼车顺路同行”平台正是为解决这一痛点而设计。平台通过信息化手段,将具有相同或相近出行路线、出行时间的师生连接起来,实现车主与乘客的精准匹配。其意义主要体现在以下几个方面:
- 节约出行成本:乘客分摊油费,车主降低养车压力,实现双赢。
- 缓解交通压力:提高车辆座位利用率,减少校园周边道路拥堵和停车难问题。
- 促进绿色出行:减少碳排放,符合国家“双碳”战略和绿色校园建设方向。
- 拓展社交圈层:为同校师生提供跨年级、跨专业的交流机会,营造互助友爱的校园氛围。
2. 系统技术栈
本平台采用前后端分离的架构设计,后端基于 Spring Boot 框架构建,前端采用 Vue.js 生态,数据库选用 MySQL,整体技术选型成熟稳定、生态完善,适合校园级应用场景。
| 层次 | 技术选型 | 说明 |
|---|---|---|
| 后端框架 | Spring Boot 2.7.x | 简化配置,快速构建 RESTful API |
| 持久层框架 | MyBatis-Plus | 简化 CRUD 操作,内置分页插件 |
| 数据库 | MySQL 8.0 | 存储用户、行程、订单等核心数据 |
| 权限认证 | Spring Security + JWT | 无状态认证,保障接口安全 |
| 前端框架 | Vue 3 + Element Plus | 组件化开发,界面友好 |
| 实时通信 | WebSocket | 实现消息通知和行程状态实时推送 |
| 缓存中间件 | Redis | 缓存热点数据,提升查询性能 |
| 接口文档 | Swagger / Knife4j | 自动生成在线接口文档 |
| 构建工具 | Maven | 依赖管理与项目构建 |
3. 系统功能模块设计
平台围绕“发布行程—搜索匹配—确认拼车—行程管理—信用评价”这一核心业务闭环,设计了以下主要功能模块:
3.1 用户管理模块
支持学生、教职工的注册登录,实现身份认证、个人信息维护、学生证/校园卡认证、信用积分管理等功能。用户可绑定手机号和常用路线,便于快速发布和匹配行程。
3.2 行程发布模块
车主可发布拼车行程,填写出发地、目的地、出发时间、途经站点、可用座位数、期望分摊费用等信息。系统自动生成行程详情页,并支持对行程进行上下架管理。
3.3 智能匹配与搜索模块
乘客可根据起点、终点、出发时间范围等条件检索可用行程。系统基于路线相似度和时间窗口进行智能排序,优先展示顺路程度高、车主信用好的行程,提升匹配效率。
3.4 订单管理模块
乘客提交拼车申请后,车主可查看申请列表并进行同意或拒绝操作。订单状态覆盖待确认、已确认、进行中、已完成、已取消等全生命周期,双方可实时查看订单进度。
3.5 消息通知模块
基于 WebSocket 实现站内消息实时推送,包括拼车申请提醒、订单状态变更通知、行程取消通知等,确保用户及时掌握动态。
3.6 信用评价模块
行程完成后,双方可互评,评价维度包括守时、沟通、车况、文明程度等。信用积分影响用户在平台上的排序权重和信任等级,形成良性循环的信用体系。
4. 数据库设计
系统核心数据表包括用户表、行程表、订单表、评价表和消息表。以下给出主要表结构设计:
4.1 用户表(t_user)
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键,自增 |
| username | varchar(50) | 登录用户名 |
| password | varchar(100) | 加密后的密码 |
| real_name | varchar(50) | 真实姓名 |
| phone | varchar(20) | 手机号 |
| user_type | tinyint | 用户类型:0-学生,1-教职工 |
| credit_score | int | 信用积分 |
| create_time | datetime | 注册时间 |
4.2 行程表(t_trip)
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键,自增 |
| owner_id | bigint | 发布人ID |
| start_point | varchar(100) | 出发地 |
| end_point | varchar(100) | 目的地 |
| depart_time | datetime | 出发时间 |
| available_seats | int | 可用座位数 |
| fee_per_seat | decimal(10,2) | 每座分摊费用 |
| status | tinyint | 状态:0-招募中,1-已满员,2-已取消 |
4.3 订单表(t_order)
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键,自增 |
| trip_id | bigint | 行程ID |
| passenger_id | bigint | 乘客ID |
| seats | int | 预订座位数 |
| status | tinyint | 状态:0-待确认,1-已确认,2-进行中,3-已完成,4-已取消 |
| create_time | datetime | 下单时间 |
5. 核心代码实现
以下选取平台中几个关键业务场景的代码实现进行说明。
5.1 发布行程接口
车主发布行程时,后端需要校验用户身份、参数合法性,并将行程数据写入数据库。核心代码如下:
@RestController @RequestMapping("/api/trip") public class TripController { @Resource private TripService tripService; @PostMapping("/publish") public Result<Trip> publish(@RequestBody TripDTO dto, @RequestHeader("Authorization") String token) { // 从 JWT 中解析当前登录用户 Long userId = JwtUtil.parseToken(token).getUserId(); Trip trip = tripService.publishTrip(userId, dto); return Result.success(trip); } }@Service public class TripServiceImpl implements TripService { @Resource private TripMapper tripMapper; @Override @Transactional(rollbackFor = Exception.class) public Trip publishTrip(Long userId, TripDTO dto) { // 参数校验 if (dto.getAvailableSeats() < 1 || dto.getAvailableSeats() > 6) { throw new BusinessException("座位数必须在1到6之间"); } if (dto.getDepartTime().isBefore(LocalDateTime.now())) { throw new BusinessException("出发时间不能早于当前时间"); } Trip trip = new Trip(); BeanUtils.copyProperties(dto, trip); trip.setOwnerId(userId); trip.setStatus(0); // 招募中 trip.setCreateTime(LocalDateTime.now()); tripMapper.insert(trip); return trip; } }5.2 智能匹配搜索行程
乘客搜索行程时,系统根据起终点关键词和出发时间范围进行模糊匹配,并按顺路程度和信用分排序。核心代码如下:
@Service public class TripServiceImpl implements TripService { @Override public PageResult<TripVO> searchTrips(TripQuery query) { LambdaQueryWrapper<Trip> wrapper = new LambdaQueryWrapper<>(); // 起终点模糊匹配 if (StringUtils.hasText(query.getStartPoint())) { wrapper.like(Trip::getStartPoint, query.getStartPoint()); } if (StringUtils.hasText(query.getEndPoint())) { wrapper.like(Trip::getEndPoint, query.getEndPoint()); } // 出发时间范围过滤 if (query.getStartTime() != null) { wrapper.ge(Trip::getDepartTime, query.getStartTime()); } if (query.getEndTime() != null) { wrapper.le(Trip::getDepartTime, query.getEndTime()); } // 仅查询招募中的行程 wrapper.eq(Trip::getStatus, 0); // 按出发时间升序排列 wrapper.orderByAsc(Trip::getDepartTime); Page<Trip> page = new Page<>(query.getPageNum(), query.getPageSize()); Page<Trip> tripPage = tripMapper.selectPage(page, wrapper); // 组装返回结果,附带车主信用分用于前端排序展示 List<TripVO> voList = tripPage.getRecords().stream().map(trip -> { TripVO vo = new TripVO(); BeanUtils.copyProperties(trip, vo); User owner = userMapper.selectById(trip.getOwnerId()); vo.setOwnerName(owner.getRealName()); vo.setOwnerCredit(owner.getCreditScore()); return vo; }).collect(Collectors.toList()); return new PageResult<>(voList, tripPage.getTotal()); } }5.3 拼车订单确认
乘客提交拼车申请后,车主确认订单时需要校验座位余量,并采用乐观锁防止超卖。核心代码如下:
@Service public class OrderServiceImpl implements OrderService { @Resource private OrderMapper orderMapper; @Resource private TripMapper tripMapper; @Override @Transactional(rollbackFor = Exception.class) public void confirmOrder(Long orderId, Long ownerId) { Order order = orderMapper.selectById(orderId); if (order == null || !order.getStatus().equals(0)) { throw new BusinessException("订单不存在或已被处理"); } Trip trip = tripMapper.selectById(order.getTripId()); if (!trip.getOwnerId().equals(ownerId)) { throw new BusinessException("无权操作该订单"); } // 乐观锁扣减座位数,防止并发超卖 int rows = tripMapper.reduceSeats(trip.getId(), order.getSeats(), trip.getVersion()); if (rows == 0) { throw new BusinessException("座位余量不足,请刷新后重试"); } order.setStatus(1); // 已确认 orderMapper.updateById(order); } }@Update("UPDATE t_trip SET available_seats = available_seats - #{seats}, " + "version = version + 1 WHERE id = #{id} AND available_seats >= #{seats} AND version = #{version}") int reduceSeats(@Param("id") Long id, @Param("seats") Integer seats, @Param("version") Integer version);6. 系统安全与性能优化
为保证平台稳定运行,系统在安全和性能方面做了以下设计:
- 接口安全:采用 JWT 无状态认证,配合 Spring Security 实现接口级权限控制,敏感操作校验用户身份。
- 数据加密:用户密码使用 BCrypt 算法加密存储,防止明文泄露。
- 防超卖设计:座位扣减采用乐观锁机制,避免高并发场景下出现座位超卖。
- 缓存加速:热门路线和常用搜索条件使用 Redis 缓存,降低数据库压力,提升响应速度。
- SQL 防注入:持久层统一使用 MyBatis-Plus 参数化查询,杜绝 SQL 注入风险。
7. 总结与展望
本文设计并实现了一个基于 Spring Boot 的校园“拼车顺路同行”平台,覆盖了用户管理、行程发布、智能匹配、订单管理、消息通知和信用评价等核心功能。系统采用前后端分离架构,技术栈成熟、扩展性强,能够有效解决校园出行中车辆空座闲置与师生出行需求之间的信息不对称问题。
后续可在以下方向继续优化:引入地图 API 实现路线规划和顺路度精确计算;基于用户历史行为构建推荐算法,提升匹配精准度;增加支付结算功能,实现在线分摊费用;对接学校统一身份认证系统,简化注册流程。随着校园数字化建设的推进,该类平台具有广阔的应用前景和推广价值。
