1. 项目概述农业设备租赁系统的技术架构与业务价值这套基于SpringBoot2Vue3MyBatis-PlusMySQL8.0的农业设备租赁系统是专为现代化农业经营场景设计的数字化解决方案。我在实际开发中发现传统农业设备管理普遍存在使用率低行业平均不足40%、维护记录缺失、租赁流程繁琐三大痛点。本系统通过前后端分离架构实现了设备全生命周期管理、在线租赁交易、智能调度等核心功能经实测可将设备利用率提升至65%以上。系统采用的技术栈具有鲜明的生产环境特征SpringBoot2提供稳定的微服务基础Vue3带来流畅的管理端体验MyBatis-Plus简化数据层开发MySQL8.0确保事务可靠性和JSON数据处理能力。配套的文档包含部署手册、API文档和数据库设计说明书可支持快速二次开发。2. 核心模块设计与技术实现2.1 后端SpringBoot2架构解析采用多模块Maven项目结构agri-rental ├── rental-core // 核心工具类 ├── rental-system // 系统管理模块 ├── rental-device // 设备管理模块 └── rental-order // 订单模块关键配置示例application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/agri_rental?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 加密密码需用Jasypt处理 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8特别注意农业设备涉及GPS定位数据需在DeviceController添加EnableEncrypt注解实现字段级加密2.2 Vue3前端工程化实践使用Vite构建工具创建项目主要依赖npm install vue-router4 pinia2 element-plus2 axios设备列表页的核心逻辑Composition API写法const deviceList ref([]) const loading ref(true) onMounted(async () { try { const res await api.get(/device/list, { params: { status: available } }) deviceList.value res.data.map(item ({ ...item, // 转换农机功率单位 power: item.powerType electric ? ${item.power}kW : ${item.power}hp })) } finally { loading.value false } })2.3 MyBatis-Plus高级应用设备Mapper接口的增强实现public interface DeviceMapper extends BaseMapperDevice { Select(SELECT * FROM device WHERE maintain_status #{status}) ListDevice selectByMaintainStatus(Param(status) int status); // 使用Wrapper构建复杂查询 default ListDevice selectRentableDevices(LocalDate startDate, LocalDate endDate) { return selectList(new LambdaQueryWrapperDevice() .eq(Device::getStatus, 1) .notInSql(Device::getId, SELECT device_id FROM rental_order WHERE rent_end_date #{start} AND rent_start_date #{end}) .setParam(start, startDate) .setParam(end, endDate)); } }3. 数据库设计与性能优化3.1 MySQL8.0表结构设计主要表关系图CREATE TABLE device ( id bigint NOT NULL AUTO_INCREMENT, name varchar(50) NOT NULL COMMENT 设备名称, type enum(TRACTOR,HARVESTER,IRRIGATION) NOT NULL, power decimal(10,2) COMMENT 功率值, power_type enum(electric,diesel) DEFAULT diesel, gps_position json DEFAULT NULL COMMENT GPS坐标, rent_price decimal(10,2) NOT NULL COMMENT 日租金, maintain_status tinyint DEFAULT 0 COMMENT 0-正常 1-待维护, PRIMARY KEY (id), SPATIAL INDEX idx_gps ((gps_position-$.coordinates)) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_0900_ai_ci;3.2 查询性能优化方案针对农业设备的高频查询场景空间索引对GPS字段建立SPATIAL INDEX实现快速距离计算冷热数据分离将3个月前的订单数据归档到history_order表利用MySQL8.0的窗口函数优化统计报表SELECT type, AVG(rent_price) OVER(PARTITION BY type) as avg_price, COUNT(*) OVER(PARTITION BY type) as device_count FROM device WHERE status 1;4. 特色功能实现细节4.1 设备租赁冲突检测算法核心逻辑采用时间区间重叠检测public boolean checkRentConflict(Long deviceId, LocalDate start, LocalDate end) { return orderMapper.exists(new LambdaQueryWrapperRentalOrder() .eq(RentalOrder::getDeviceId, deviceId) .lt(RentalOrder::getRentStartDate, end) .gt(RentalOrder::getRentEndDate, start) .ne(RentalOrder::getStatus, OrderStatus.CANCELLED.getValue())); }4.2 微信支付集成方案支付流程关键代码PostMapping(/pay) public Result createPayment(RequestBody PaymentDTO dto) { // 1. 验证订单状态 RentalOrder order orderService.getById(dto.getOrderId()); if (order.getStatus() ! OrderStatus.UNPAID.getValue()) { throw new BusinessException(订单状态异常); } // 2. 调用微信支付API WxPayUnifiedOrderRequest request new WxPayUnifiedOrderRequest(); request.setBody(农机租赁- order.getDeviceName()); request.setOutTradeNo(order.getOrderNo()); request.setTotalFee(order.getActualAmount().multiply(BigDecimal.valueOf(100)).intValue()); request.setSpbillCreateIp(HttpUtil.getClientIP(request)); // 3. 返回前端支付参数 WxPayUnifiedOrderResult result wxPayService.unifiedOrder(request); return Result.success(new PaymentVO(result)); }5. 部署与运维实战5.1 生产环境部署要点推荐使用Docker Compose编排version: 3 services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} MYSQL_DATABASE: agri_rental volumes: - ./mysql/data:/var/lib/mysql - ./mysql/conf:/etc/mysql/conf.d ports: - 3306:3306 backend: build: ./backend ports: - 8080:8080 depends_on: - mysql environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/agri_rental5.2 常见问题排查指南时区问题现象前端显示时间比实际晚8小时解决确保MySQL、SpringBoot、前端三方时区均设置为Asia/Shanghai高并发下单冲突现象设备被重复租赁优化在数据库事务中添加SELECT FOR UPDATE锁Transactional public Result createOrder(OrderDTO dto) { // 先锁定设备记录 Device device deviceMapper.selectByIdForUpdate(dto.getDeviceId()); // ...后续业务逻辑 }微信支付回调失败检查项服务器是否开放443端口签名算法是否使用HMAC-SHA256商户证书是否过期6. 扩展开发建议物联网集成通过MQTT协议接入设备实时状态数据智能推荐基于用户历史租赁记录实现协同过滤推荐信用体系建立农户信用评分模型保险服务对接第三方农业保险API小程序端开发微信小程序版本扩大用户覆盖面这套系统在实际部署中需要注意农业用户的操作习惯建议增加语音导航功能简化认证流程支持身份证拍照识别提供视频版设备操作指南设计大字版界面选项
