ARTICLE · 1366154
JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5
CITY FREIGHT SYSTEM / JAVA 货运 · 跑腿 · 搬家 · 司机运力 JAVA同城货运跑腿搬家系统源码支持多端用户下单、司机抢单,一套后台跑通三端 Spring Boot · MyBatis-Plus · MySQLuni-app · Vue + ElementUI 用车分类 / 车型管理 / 订单管理计价管理 / 司机入驻 / 保证金 |
同城货运最难的不是把车叫来,而是把「货、车、价、人」四件事对上:用户说不清货有多重,司机说不清该收多少,平台说不清这一单谁该负责。
这套系统把一次运输拆成一条可追踪的链路:选车型 → 填货物 → 算价下单 → 司机抢单 → 运输 → 完成结算。用户端覆盖小程序、公众号与 H5,司机端独立承接抢单与接单,后台统一管车型、订单、司机、车辆与保证金。
文中截图均为演示数据,已对手机号、订单号、联系人、详细地址与车牌做脱敏处理。十个功能按链路顺序逐项拆开。
一、功能总览
十个功能点覆盖「用户下单侧」与「司机运力侧」两套角色。先用一张表说清每个模块各自解决什么问题。
01 / SCENE 用车分类 解决用户不知道该叫哪种车、场景与车型对不上的问题。 | 02 / MODEL 车型管理 解决载重、体积、价格口径不统一,报价靠拍脑袋的问题。 |
03 / ORDER 订单管理 解决订单状态不透明、客服只能反复打电话问司机的问题。 | 04 / GOODS 货物管理 解决货不对板、重量体积没留证,出问题各说各话的问题。 |
05 / PRICE 计价管理 解决起步价、里程费、楼层搬运费算不清、临时加价的问题。 | 06 / DRIVER 司机入驻 解决运力从哪来、资质谁来审、审核标准不一的问题。 |
07 / FLEET 车辆管理 解决车牌、车型、年检保险与实际运力对不上的问题。 | 08 / DEPOSIT 保证金 解决司机爽约、货损扯皮没有约束手段的问题。 |
09 / VERIFY 认证管理 解决冒名接单、证件过期仍在跑单的问题。 | 10 / POINTS 积分商城 解决司机完成订单后没有正向激励、留存差的问题。 |
二、功能拆解
十个模块分两条线:前五个服务用户下单与履约,后五个服务司机运力与平台治理。下面按「输入—状态—输出」逐项说明。
01 用车分类:先让用户选对场景
用户通常不知道「中面」能装多少,但知道自己要「搬家」还是「送个文件」。用车分类就是把用户的场景语言翻译成车型。
系统把场景做成配置:一个场景绑定若干车型,首页按场景展示入口,选了搬家就不再出现小面包,从源头减少选错车导致的改单。
跑腿与货运共用一套订单,但计价规则不同:跑腿按距离与时段,货运按车型与里程。分类层只做路由,不写死价格。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 01|用户端首页叫车、我的订单与个人中心,展示场景入口与车型选择;截图数据为演示数据。 |
02 车型管理:把载重、体积和价格做成字段
车型不是一张图片配一段文案,而是一组参数:能装多少、多少钱起步、每公里多少。这些参数决定报价,也决定司机能不能接。
系统把车型做成独立表,订单保存车型名称与价格快照,运营调价不影响已下的单。停用车只挡新单,不会让在途订单失去归属。
载重与体积还参与校验:用户填的货物超过车型上限时,下单前就提示换车,而不是等司机到了再拒载。
03 订单管理:一单从下单到完成,状态要能对得上
货运订单的生命周期比电商短,但状态更多:待接单时有司机抢单,运输中可能改地址,完成后还有货损申诉。状态机必须把这些岔路都写清楚。
系统用显式 from→to 流转,抢单、改派、取消都走条件更新,同一单只能有一个司机。每次流转写操作日志,谁在什么时间改的都能查。
报价有有效期:用户看到的价格只保留 15 分钟,超时重新算价,避免油价或距离变化后仍按旧价成交。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 02|司机端接单详情与订单详情,展示距离货地、接单信息与费用明细;截图数据为演示数据。 |
04 货物管理:把「一车货」说成可核对的数据
「大概一车」是货运纠纷的起点。重量、体积、包装方式说不清,司机到场发现装不下,加价或拒载都合理。
系统把货物做成结构化字段:名称、包装、重量、体积,超出车型上限时直接拦下。备注支持填写易碎、需搬运等特殊要求,司机接单前就能看到。
货物信息随订单保存快照,后续用户修改不影响已接单的订单,避免司机按旧信息到场。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 03|用户端订单详情、货物信息与确认订单,展示货物字段与运费明细;截图数据为演示数据。 |
05 计价管理:报价要能拆开给人看
货运最容易吵架的地方就是价格。用户看到 65 元,司机到场说要 120,因为他爬了六楼还有大件。解决办法不是压价,而是把费用项提前拆开。
系统把费用拆成五项:起步价、里程费、楼层费、搬运费、夜间费。每一项都有规则来源,能展开给用户看,下单时锁定报价,路上不临时加价。
平台服务费单独记账,不和司机收入混在一起,既方便对账,也避免「平台抽成不明」的质疑。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 04|我的钱包、计价规则与下单页,展示里程计价与附加费口径;截图数据为演示数据。 |
06 司机入驻:运力从哪来、资质谁来审
同城货运是典型的双边平台:没有司机,用户下单也没人接。入驻流程既要快,又要把资质卡住。
系统把入驻拆成三步:填资料 → 证件核验 → 人工审核。证件未全部通过时不允许审核通过,从流程上避免「人车不符」;审核记录留痕,谁批的、什么时候批的可查。
审核通过只是起点,后续还要接车辆管理、保证金与认证管理三条线,任何一条失效都不能接单。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 05|司机端工作台、抢单池与订单中心,展示接单入口与运力状态;截图数据为演示数据。 |
07 车辆管理:车牌、车型与证件要对得上
货运平台的责任绕不开车:车不合规、证过期,出了事平台要担责。车辆管理不是登记表,而是准入闸门。
系统给每辆车建独立档案,绑定司机与证件有效期,到期前 30 天提醒,过期自动下线。一个司机可以绑多辆车,但同时只能有一辆在接单。
车辆信息与订单关联:订单详情里能看到实际承运车辆,出现货损时可追溯到具体车与证件。
![]() |
【JAVA同城服务货运跑腿搬家系统源码支持小程序+公众号+APP+H5】实拍 06|资金账户、保证金与我的车辆,展示余额、保证金状态与车辆审核结果;截图数据为演示数据。 |
08 保证金:让爽约有成本
货运的履约成本高:司机接了单不来,用户的时间就废了。保证金是最直接的约束,但收得不清楚会变成纠纷源。
系统把保证金做成账户:缴纳、冻结、解冻、扣减各写一条流水,接单冻结、完成解冻、违规扣减三条路径都可在明细里查。
资金合规要单独说:保证金应进入存管账户,平台不得挪用;扣减规则要在协议里写清,并给司机申诉入口。
09 认证管理:人、证、车三合一
认证解决的是「接单的人是不是登记的人」。冒名接单在货运里很常见,一旦出事,平台说不清承运人是谁。
系统把认证拆成四项:实名、驾驶证、行驶证、人脸。接单前校验认证状态,提现前再做一次人脸,把高风险动作单独加固。
认证数据属于敏感个人信息,存储要加密、展示要脱敏,后台只能看到必要字段,导出需审批。
10 积分商城:给司机的正向激励
只靠罚款管司机,留存一定差。积分是另一半:跑得多、评价好,就能换保养券、加油券、优先派单权。
系统按订单完成与评价发积分,每笔变动写流水,账户余额由流水汇总,不做直接改余额。兑换商品走库存与核销,避免超发。
合规上要卡死:积分不能提现、不能转让、不能兑换现金等价物;规则变更要提前公示,不能追溯扣减。
三、技术架构:用户端、司机端、后台三套界面,一套服务
这套系统有三类使用者:下单的用户、接单的司机、管平台的运营。界面分三套,接口与状态机共用一套。
结论先说:价格、派单、资质、保证金四件事必须在服务端。客户端只负责把信息收全、把结果展示清楚。
接口按 /api/app 与 /api/driver 与 /api/admin 分组,三套 token 各自鉴权;司机端接口额外校验工作状态与认证状态。抢单这类高并发接口不查缓存,直接打数据库条件更新,缓存只用于列表与地理检索。
四、数据库与核心代码
表设计围绕「车型—订单—司机—车辆—保证金」五条线。下面先给核心表,再给六段关键代码。
-- 金额统一用「分」;订单状态由服务端状态机维护CREATE TABLE freight_vehicle_type ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(40) NOT NULL COMMENT '小面包/中面/依维柯', load_kg INT NOT NULL DEFAULT 0, volume_m3 DECIMAL(6,2) NOT NULL DEFAULT 0, start_price INT NOT NULL COMMENT '起步价,分', price_per_km INT NOT NULL COMMENT '每公里,分', status TINYINT NOT NULL DEFAULT 1, KEY idx_status (status)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;CREATE TABLE freight_driver ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, real_name VARCHAR(30) NOT NULL, phone_enc VARCHAR(128) NOT NULL, driver_license VARCHAR(40) NOT NULL, audit_status TINYINT NOT NULL DEFAULT 10, -- 10待审核 20已通过 30已驳回 work_status TINYINT NOT NULL DEFAULT 0 COMMENT '0离线 1接单中', deposit_cent INT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user (user_id), KEY idx_audit (audit_status)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;CREATE TABLE freight_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, request_no VARCHAR(64) NOT NULL, user_id BIGINT NOT NULL, driver_id BIGINT DEFAULT NULL, vehicle_type BIGINT NOT NULL, from_addr VARCHAR(200) NOT NULL, to_addr VARCHAR(200) NOT NULL, goods_name VARCHAR(60) NOT NULL DEFAULT '', weight_kg INT NOT NULL DEFAULT 0, distance_m INT NOT NULL DEFAULT 0, amount_cent INT NOT NULL, status TINYINT NOT NULL DEFAULT 10, -- 10待接单 20已接单 30运输中 40已完成 50已取消 created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_order (order_no), UNIQUE KEY uk_request (request_no), KEY idx_status (status, created_at)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
三张主表覆盖主链路:freight_vehicle_type 决定报价参数,freight_driver 记录运力与审核状态,freight_order 记录每一单的货物、距离、金额与状态。金额统一用 INT 存「分」。
@Transactional(rollbackFor = Exception.class)public void grab(Long orderId, Long driverId) { // 条件更新抢占:只有「待接单」且司机为空时才能抢到 int updated = orderMapper.assign( orderId, 10, 20, driverId, LocalDateTime.now()); if (updated == 0) { // 已被别人抢走,返回明确提示而不是抛系统异常 throw new BizException("手慢了,这单已被接走"); } // 抢单成功后同步司机工作状态,一单一人,避免多单并发 int busy = driverMapper.setWorking(driverId, 0, 1); if (busy == 0) { throw new BizException("当前有进行中的订单"); } // 记录接单流水,用于后续分佣与考核 orderLogMapper.insert(orderId, driverId, "GRAB");}// Mapper 里的条件更新,靠数据库保证只有一个赢家// UPDATE freight_order SET driver_id=#{driverId}, status=20// WHERE id=#{orderId} AND status=10 AND driver_id IS NULL |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
抢单的核心不是加锁,而是一条带条件的 UPDATE:`WHERE status=10 AND driver_id IS NULL`。谁先更新成功谁就是赢家,其余请求拿到 0 行,直接提示「手慢了」。
public int calcAmount(PriceDTO dto) { VehicleType vt = typeMapper.selectById(dto.getVehicleTypeId()); if (vt == null || vt.getStatus() != 1) { throw new BizException("车型不可用"); } // 起步价含前 N 公里,超出部分按公里累加 int base = vt.getStartPrice(); int extraKm = Math.max(0, dto.getDistanceM() - FREE_KM * 1000); int mileage = (int) Math.ceil(extraKm / 1000.0) * vt.getPricePerKm(); // 附加费:楼层、搬运、夜间,全部按规则表算,不写死 int floorFee = extraFeeMapper.floorFee(dto.getFromFloor()); int carryFee = dto.getNeedCarry() ? extraFeeMapper.carryFee(dto.getWeightKg()) : 0; int nightFee = isNight(dto.getStartTime()) ? extraFeeMapper.nightFee() : 0; int total = base + mileage + floorFee + carryFee + nightFee; // 平台服务费单独记,不混进司机收入 int serviceFee = Math.max(MIN_SERVICE_FEE, total * SERVICE_RATE / 100); return total + serviceFee;} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
计价这段代码的原则是「全部读配置,不写常量」:起步价、每公里价来自车型表,楼层费、搬运费、夜间费来自规则表。运营改价只改数据,不动代码。
@Transactional(rollbackFor = Exception.class)public void freezeDeposit(Long driverId, int amountCent) { // 幂等:同一司机同一笔业务号只冻结一次 if (depositMapper.existsBizNo(driverId, bizNo)) { return; } FreightDriver driver = driverMapper.selectForUpdate(driverId); if (driver.getDepositCent() < amountCent) { throw new BizException("保证金不足,请先缴纳"); } // 冻结与流水同事务,避免「扣了额度没记账」 int updated = driverMapper.freeze(driverId, amountCent); if (updated == 0) { throw new BizException("账户繁忙,请重试"); } depositMapper.insertLog(driverId, bizNo, 10, amountCent, "接单冻结");}@Transactional(rollbackFor = Exception.class)public void refundDeposit(Long driverId, String bizNo, int amountCent) { if (depositMapper.existsBizNo(driverId, bizNo)) { return; } driverMapper.unfreeze(driverId, amountCent); depositMapper.insertLog(driverId, bizNo, 30, amountCent, "订单完成退还");} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
保证金要做成账户:冻结与解冻都先查业务号做幂等,再改余额、写流水。同一笔订单重复调用只会生效一次,避免「解冻两次」。
@Transactional(rollbackFor = Exception.class)public void audit(Long driverId, boolean pass, String reason, Long operatorId) { FreightDriver driver = driverMapper.selectByIdForUpdate(driverId); if (driver == null) { throw new BizException("司机不存在"); } // 幂等:已审核过的直接返回,避免重复点击生成多条记录 if (driver.getAuditStatus() != 10) { return; } // 资质校验:驾照、行驶证、车辆信息缺一不可 if (pass) { if (!docMapper.allVerified(driverId)) { throw new BizException("证件未全部通过校验,不能审核通过"); } // 审核通过才允许缴保证金并上线接单 driverMapper.updateStatus(driverId, 20, 0); } else { driverMapper.updateStatus(driverId, 30, 0); } auditLogMapper.insert(driverId, pass ? 20 : 30, reason, operatorId);} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
审核接口必须幂等,也要卡住前置条件:证件没全部通过就不能点通过。这样即使运营误操作,也不会把不合规的司机放进来。
// 下单前取定位与距离,价格由服务端算,前端只做展示export async function createFreightOrder(form) { const loc = await getLocation(); // uni.getLocation 封装 const requestNo = genRequestNo(); // 幂等号,弱网重试不重复下单 const distance = await request({ url: '/api/app/freight/distance', method: 'POST', data: { from: form.from, to: form.to, coord: loc }, }); const price = await request({ url: '/api/app/freight/quote', method: 'POST', data: { vehicleTypeId: form.vehicleTypeId, distanceM: distance.meters, fromFloor: form.fromFloor, needCarry: form.needCarry, }, }); // 用户确认价格后才真正下单 return request({ url: '/api/app/freight/order', method: 'POST', data: { ...form, requestNo, quoteId: price.quoteId }, });} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
多端下单的顺序是「先算距离、再报价、后下单」,三步分开的好处是用户能在付款前看到明细;每一步都带幂等号,弱网重试不会产生重复订单。
<template> <div class="freight-page"> <el-form :inline="true" :model="query" size="small"> <el-form-item label="状态"> <el-select v-model="query.status" clearable placeholder="全部"> <el-option label="待接单" :value="10" /> <el-option label="已接单" :value="20" /> <el-option label="运输中" :value="30" /> <el-option label="已完成" :value="40" /> </el-select> </el-form-item> <el-form-item label="订单号"> <el-input v-model="query.orderNo" clearable placeholder="请输入订单号" /> </el-form-item> <el-form-item> <el-button type="primary" @click="load(1)">查询</el-button> </el-form-item> </el-form> <el-table v-loading="loading" :data="rows" size="small" border> <el-table-column prop="orderNo" label="订单号" width="170" /> <el-table-column prop="fromAddr" label="起点" min-width="150" show-overflow-tooltip /> <el-table-column prop="toAddr" label="终点" min-width="150" show-overflow-tooltip /> <el-table-column label="金额" width="96"> <template slot-scope="{ row }">{{ money(row.amountCent) }}</template> </el-table-column> <el-table-column label="状态" width="96"> <template slot-scope="{ row }"> <el-tag size="small" :type="tagType(row.status)"> {{ statusText(row.status) }} </el-tag> </template> </el-table-column> <el-table-column label="操作" width="150" fixed="right"> <template slot-scope="{ row }"> <el-button v-if="row.status === 10" type="text" @click="dispatch(row)">指派司机</el-button> <el-button type="text" @click="detail(row)">详情</el-button> </template> </el-table-column> </el-table> <el-pagination background layout="total, prev, pager, next" :total="total" :page-size="query.size" :current-page="query.page" @current-change="load" /> </div></template> |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
后台表格是标准四件套:查询、状态标签、行内操作、分页。状态文案与颜色集中在两个函数里,新增状态改一处即可。
五、合规与上线检查:货运平台的红线
道路运输资质:从事道路货物运输需具备相应经营许可,平台若以承运人身份接单,责任更重;若仅为信息中介,需在协议中明确身份与责任边界。车辆需有营运证,驾驶员需有从业资格证,普通货运与危险品运输不可混用。
司机与车辆审核:人、证、车三者必须一致:驾驶证准驾车型、行驶证车辆类型、平台接单车型要能对上;证件有效期到期自动限制接单。审核记录留存,监管抽查时能提供。
禁运与查验:页面明示禁止运输危险品、违禁品、活体动物等;下单时做品类勾选与提示,司机有权验货并拒运。发现违禁品应有上报与留证流程。
计价与加价:所有费用项需在下单前明示,不得途中临时加价;楼层费、搬运费按规则计算并可展开明细。平台服务费单独列示,不与司机收入混算。
保证金与资金:保证金应进入存管账户,平台不得挪用;扣减规则写入协议并提供申诉入口;提现需实名与人脸校验,防范洗钱风险。
位置与个人信息:行程轨迹、手机号、详细地址属于敏感个人信息,最小化收集、加密存储、按角色授权;司机端只在履约期间可见必要信息,完成后脱敏。
上线前建议逐条对照:经营许可与车辆营运证是否齐全、司机资质审核流程是否落地、禁运提示是否显著、计价明细是否可展开、保证金是否有存管、投诉与保险理赔入口是否可用。
六、这套源码适合谁
第一类是同城货运与搬家团队:有车有人,缺一套能接单、能调度、能对账的系统。
第二类是跑腿与即时配送服务商:需要把「小件跑腿」和「整车货运」放在同一套订单体系里。
第三类是软件团队:需要一套结构清楚、可二开的货运模板,替换地图、支付、短信与电子签即可交付客户。
不适合的场景也说清楚:只做信息撮合、不做履约与结算的平台,重点不在订单状态机,而在撮合与风控;危险品运输需要另做资质与合规体系,不能直接套用。
七、常见问题
Q1 支持小程序、公众号、H5 和 APP 吗?
用户端用 uni-app(Vue 语法)一套代码编译到小程序、H5 与 App,公众号通过 H5 承载;司机端同样是 uni-app,后台是 Vue + ElementUI,服务端 Spring Boot。
Q2 同一单被多个司机同时抢怎么办?
数据库条件更新兜底:`WHERE status=10 AND driver_id IS NULL`,只有一个请求能更新成功,其余返回「已被接走」,不会出现一单两司机。
Q3 价格会不会到了现场被临时加价?
不会。楼层费、搬运费、夜间费在下单前按规则算入报价并展示明细,报价锁定 15 分钟;司机端没有改价入口,异常情况走客服改派或取消。
Q4 保证金能退吗?
能。订单完成自动解冻,司机可申请退还;违规扣减需有明确规则与证据,并保留申诉通道。
八、结语
同城货运的竞争力,一半在运力密度,一半在「不出事」:价格说得清、司机审得严、货损有凭证、爽约有成本。系统能做的,就是把这些动作变成可查的状态与流水。
如果你正在做同城货运、跑腿或搬家业务,或想基于 Spring Boot + MyBatis-Plus + MySQL、uni-app、Vue + ElementUI 做一套可二开的多端货运系统,欢迎找我领取演示资料和部署说明。





















































































