SpringBoot+Vue3全栈物资管理系统开发实践
发布时间：2026/9/17 22:44:56 作者：尧图编辑部 阅读量：1,286
1. 项目概述现代企业物资管理系统的技术实现物资管理系统是企业资源计划ERP中的重要组成部分它直接关系到企业运营效率和成本控制。传统物资管理往往依赖手工记录或单机软件存在数据孤岛、流程不透明、统计滞后等问题。这套基于SpringBootVue3MyBatis的全栈解决方案正是为了解决这些痛点而生。我在实际企业信息化建设中多次实施类似系统发现现代物资管理系统需要具备三个核心能力实时库存可视化避免超卖或断货、全流程追踪从采购到报废的完整生命周期、智能预警低库存自动提醒。本系统采用前后端分离架构前端使用Vue3组合式API开发响应式界面后端基于SpringBoot提供RESTful API数据持久层采用MyBatis-Plus增强效率MySQL作为关系型数据库保证事务一致性。关键提示选择前后端分离架构时务必提前规划好API文档规范我们团队使用Swagger UIYAPI否则后期联调阶段会出现大量沟通成本。建议在项目启动时就定义好状态码规范、日期格式、枚举值等通用约定。2. 技术栈选型与架构设计2.1 后端技术栈深度解析SpringBoot 2.7.x作为基础框架其自动配置特性大幅减少了XML配置。我在实际开发中特别依赖两个功能Actuator端点监控搭配Prometheus实现性能指标采集和Profile多环境配置通过application-dev.yml、application-prod.yml实现环境隔离。对于物资管理系统特有的业务场景我们重点集成了以下组件Spring Security JWT采用RBAC基于角色的访问控制模型设计五类角色系统管理员、采购专员、仓库管理员、部门领用人、财务审计员。权限颗粒度精确到按钮级别例如库存预警菜单仅对仓库管理员可见。MyBatis-Plus 3.5.x其Lambda查询构建器大幅简化了DAO层代码。例如物资分页查询只需PageMaterial page new Page(current, size); return materialMapper.selectPage(page, Wrappers.MateriallambdaQuery() .like(StringUtils.isNotBlank(keyword), Material::getName, keyword) .eq(status ! null, Material::getStatus, status));阿里云OSS用于物资图片上传通过自定义Starter实现一键配置。这里有个踩坑经验文件上传一定要做Content-Type校验我们曾遭遇过用户上传伪装的.jpg文件实际包含恶意脚本的情况。2.2 前端技术栈创新实践Vue3的组合式API相比Options API更适合复杂业务场景。在物资管理系统中我们特别优化了以下场景物资选择器组件使用script setup语法配合v-model双向绑定实现跨页面级联选择。关键代码结构script setup const emit defineEmits([update:modelValue]) function handleSelect(item) { emit(update:modelValue, item.id) } /script库存实时看板通过WebSocket连接后端消息代理我们选用RabbitMQ的STOMP插件当库存变更时推送消息到前端。注意要处理断线重连实测中我们发现iOS Safari的WebSocket在切换网络时会静默断开。打印导出优化使用xlsx库实现Excel导出配合虚拟滚动技术解决万级数据导出时的内存溢出问题。打印方案采用PDF.js渲染服务端生成的PDF避免直接调用浏览器打印API导致的样式错乱。2.3 数据库设计要点MySQL 8.0的表设计遵循几个原则① 库存相关表必须加行级锁SELECT ... FOR UPDATE② 操作记录表按月份分表 ③ 所有删除操作都是逻辑删除。核心表结构示例CREATE TABLE t_material ( id BIGINT PRIMARY KEY, code VARCHAR(32) UNIQUE COMMENT 物资编码, name VARCHAR(64) NOT NULL, spec VARCHAR(128) COMMENT 规格型号, unit VARCHAR(16) COMMENT 计量单位, current_stock DECIMAL(12,3) DEFAULT 0 COMMENT 当前库存, min_stock DECIMAL(12,3) COMMENT 最低库存预警线, is_deleted TINYINT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_stock_log ( id BIGINT PRIMARY KEY, material_id BIGINT NOT NULL, before_quantity DECIMAL(12,3), change_quantity DECIMAL(12,3) COMMENT 正数表示入库, operator_id BIGINT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB;重要经验物资编码material.code一定要设计为业务无关的流水号我们曾遇到客户要求将物资分类信息编码到编号中结果后期分类体系变更导致大量历史数据混乱。3. 核心业务模块实现3.1 智能采购预警模块传统采购依赖人工盘点本系统通过三个维度实现智能预警安全库存阈值当current_stock min_stock时触发预警领用趋势预测基于过去90天的领用记录计算日均消耗量结合采购周期生成建议采购量保质期提醒对有效期敏感的物资如化学试剂在过期前30天提醒后端算法核心逻辑public ListPurchaseAdvice generateAdvice() { // 获取低于安全库存的物资 ListMaterial lowStockMaterials materialMapper.selectList( Wrappers.MateriallambdaQuery() .lt(Material::getCurrentStock, Material::getMinStock)); return lowStockMaterials.stream().map(material - { PurchaseAdvice advice new PurchaseAdvice(); // 计算建议采购量安全库存-当前库存日均消耗*采购周期 double avgDailyUse getAvgDailyUse(material.getId()); int purchaseLeadDays getPurchaseLeadDays(material.getSupplierId()); double suggestedQuantity material.getMinStock() - material.getCurrentStock() avgDailyUse * purchaseLeadDays; advice.setMaterialId(material.getId()); advice.setSuggestedQuantity(suggestedQuantity); return advice; }).collect(Collectors.toList()); }3.2 全流程追踪系统每个物资从入库到报废会经历多个状态我们采用状态模式State Pattern设计状态机stateDiagram-v2 [*] -- 已入库 已入库 -- 领用中 : 提交领用申请 领用中 -- 已领用 : 仓库确认 已领用 -- 使用中 : 用户确认接收 使用中 -- 维修中 : 报修 维修中 -- 使用中 : 维修完成 使用中 -- 已报废 : 达到报废条件对应Java实现public interface MaterialState { void handleRequest(MaterialContext context); } public class InStockState implements MaterialState { Override public void handleRequest(MaterialContext context) { if (APPLY.equals(context.getEvent())) { context.setState(new ApplyingState()); // 生成领用申请单... } } }前端使用El-Table配合自定义状态标签展示流转过程el-table-column label状态 template #default{row} el-tag :typestateTagMap[row.state] {{ stateTextMap[row.state] }} /el-tag /template /el-table-column3.3 多维度报表系统利用MyBatis的动态SQL实现灵活查询select idselectStatistics resultTypeMaterialStatsDTO SELECT m.id, m.name, SUM(CASE WHEN sl.change_quantity 0 THEN sl.change_quantity ELSE 0 END) AS total_in, SUM(CASE WHEN sl.change_quantity 0 THEN -sl.change_quantity ELSE 0 END) AS total_out FROM t_material m LEFT JOIN t_stock_log sl ON m.id sl.material_id where if testdepartmentId ! null AND sl.department_id #{departmentId} /if if testbeginDate ! null AND sl.create_time #{beginDate} /if /where GROUP BY m.id /select前端数据可视化使用ECharts实现钻取式报表const renderStockTrendChart (data) { const chart echarts.init(document.getElementById(chart)); chart.setOption({ tooltip: { trigger: axis }, xAxis: { type: category, data: data.months }, yAxis: { type: value }, series: [{ data: data.values, type: line, areaStyle: {} }] }); }4. 部署与性能优化4.1 后端部署方案采用Docker Compose编排服务version: 3 services: app: image: openjdk:17-jdk ports: - 8080:8080 volumes: - ./logs:/app/logs environment: - SPRING_PROFILES_ACTIVEprod mysql: image: mysql:8.0 environment: - MYSQL_ROOT_PASSWORDyourpassword volumes: - ./mysql-data:/var/lib/mysql redis: image: redis:6关键优化参数JVM参数-XX:UseG1GC -Xmx2g -Xms2g根据服务器内存调整Tomcat连接池spring.datasource.hikari.maximum-pool-size20二级缓存整合Redis实现热点数据缓存配置TTL为5分钟4.2 前端性能调优路由懒加载const routes [ { path: /report, component: () import(./views/Report.vue) } ]打包优化vite.config.jsexport default defineConfig({ build: { rollupOptions: { output: { manualChunks(id) { if (id.includes(node_modules)) { return vendor } } } } } })CDN加速将Element Plus、ECharts等静态资源通过script标签引入5. 常见问题解决方案5.1 库存超卖问题现象并发领用时库存出现负数 解决方案悲观锁方案Transactional public boolean reduceStock(Long materialId, BigDecimal quantity) { Material material materialMapper.selectByIdForUpdate(materialId); // FOR UPDATE if (material.getCurrentStock().compareTo(quantity) 0) { material.setCurrentStock(material.getCurrentStock().subtract(quantity)); return materialMapper.updateById(material) 0; } return false; }乐观锁方案适合低并发场景Transactional public boolean reduceStock(Long materialId, BigDecimal quantity) { Material material materialMapper.selectById(materialId); if (material.getCurrentStock().compareTo(quantity) 0) { int updated materialMapper.updateStock( materialId, quantity, material.getVersion()); // version字段 return updated 0; } return false; }5.2 树形物资分类性能问题现象分类层级超过4级时加载缓慢 优化方案采用闭包表设计代替邻接表CREATE TABLE t_category_closure ( ancestor BIGINT NOT NULL, descendant BIGINT NOT NULL, depth INT NOT NULL, PRIMARY KEY (ancestor, descendant) );前端使用虚拟树组件el-tree-v2 :datatreeData :height400 :props{ label: name, children: children } :node-keyid /5.3 批量导入内存溢出现象导入5000条Excel数据时OOM 解决方案使用Apache POI的SAX模式解析OPCPackage pkg OPCPackage.open(inputStream); XSSFReader reader new XSSFReader(pkg); XMLReader parser SAXHelper.newXMLReader(); parser.setContentHandler(new SheetHandler(batchSize)); parser.parse(reader.getSheet(data));分批次提交Transactional(propagation Propagation.REQUIRES_NEW) public void batchInsert(ListMaterial batch) { materialMapper.batchInsert(batch); }6. 扩展与二次开发建议在实际项目中我们通常会根据客户需求进行以下扩展移动端适配使用Uni-app打包生成微信小程序实现扫码盘点功能物联网集成通过MQTT协议连接电子秤、RFID设备实现自动入库工作流引擎集成Activiti实现多级审批流程多租户支持通过动态数据源实现SaaS化部署对于希望深入学习的朋友建议从以下方向入手研究Spring Cache的缓存穿透/雪崩解决方案尝试用WebAssembly优化前端复杂计算探索TDD开发模式为关键模块补充单元测试使用JMeter进行压力测试找出系统瓶颈
尧图网站开发 