拓冰网站定制 
简介星云ERP是一套基于SpringBoot的中小企业进销存管理系统完全开源且永久免费专为小微型商贸与零售企业设计旨在通过线上化、透明化的业务流程解决开店、日常管理和数据统计难等痛点。整个资源包共包含1202个文件以Java源码1056个为核心辅以XML/YAML配置、SQL数据库脚本、FTL页面模板、Shell脚本及Dockerfile等压缩包整体大小仅1.44MB其中SQL脚本用于初始化业务数据Dockerfile支持容器化部署方便在本地或服务器环境快速启动。目前已有363人浏览学习非常适合中小企业管理者、Java开发工程师以及运维人员参考学习。资源完整覆盖基础信息、商品、采购、销售、零售、库存、盘点、结算等模块同时支持部门、角色和权限精细化管理多数业务参数均可配置贴合实际经营场景。借助Lombok配置减少重复编码结合可扩展的工程结构开发者能快速进行二次开发将系统落地为一套适合自身业务的企业级ERP平台。1. 星云ERP是什么一个SpringBoot进销存项目为什么值得你花一个下午跑通一家五金店的老板跟我算过一笔账五个员工、三个仓库每天开十几张出入库单账却全靠Excel月底对账要熬三个晚上最后发现一款螺丝账面300盒仓库里空得能跑老鼠。这种场景需要的不是一套上万元的商业ERP而是星云ERP这类基于SpringBoot框架、为中小企业做的完全开源、永久免费的进销存ERP系统。它把采购、销售、库存、数据统计收进同一套流程解决开店难、管理难、统计难让业务线上化、透明化、简易化。适合两类人被表格折磨的老板和店长以及需要给客户快速交付进销存系统的技术团队。2. 为什么中小企业上ERP总翻车从“开店难、管理难、统计难”倒推选型理由2.1 进销存管的是什么三个“难”字背后的业务闭环开店难的第一道坎不是缺钱是商品档案和价格体系没有固化。今天A记的是含税进价明天B记的是不含税进价月底一汇总毛利率忽高忽低说不出是供应商涨了价还是有人录错数。进销存的第一步是把商品、分类、单位、条形码、默认进价、默认售价、库存上下限这些主数据固定成表单让所有单据只能引用、不能随手乱写。很多ERP项目翻车不是软件不行是主数据在源头就没管住——业务线上化的前提是数据先标准化。管理难难在单据流转和责任边界。采购员开采购单库管员入库销售员开销售单谁经手就要在系统里留痕反过来一张销售单从下单到出库要经过审核、拣货、复核每一步卡住都要有明确提示。没有这套流程线上化只是把Excel搬进网页该扯皮还是扯皮。星云ERP这类进销存系统价值最大的地方是把“谁在什么时候做了什么动作”变成可追溯的数据而不是靠喊几嗓子。统计难表面看是缺报表本质是口径不统一。同一个月的销售额老板按订单日期算业务员按出库日期算财务按发票日期算谁都没错但数字就是对不上。进销存项目上线前必须先跟老板确认主营报表的口径是看开单、出库还是回款。常见做法是默认按单据审核时间出数再提供出库时间和回款时间两套可配置口径报表页面上做成下拉选择。把一个典型的中小贸易公司的流程拉直就是一条主线商品与供应商档案→采购订单→采购入库→库存增加→销售订单→销售出库→库存减少→盘点修正→报表统计。这条主线里采购和销售是两端库存是中间状态报表是最终出口。判断一个进销存项目靠不靠谱就沿着这条主线走一遍看每个环节的单据状态、库存变化和金额结转能不能闭环。2.2 为什么选SpringBoot做进销存ERP第二天就能改需求才是关键进销存ERP的业务规则重。一张销售单的状态机新建、已审核、已出库、已退货、库存扣减的并发控制、成本计算的精度这些都需要在一个成熟的编程模型里收敛。SpringBoot自带的Spring框架提供了声明式事务一个Transactional注解就能把库存扣减和单据状态更新放进同一事务失败一起回滚。这一点在PHP或Node工程里要靠自己搭不少基础设施一旦处理不当就会出现“单子成功、库存没减”这种让开发给客户赔笑脸的脏数据。SpringBoot在国内的生态积累也实在。MyBatis或MyBatis-Plus做持久层、Spring Security或Sa-Token做权限、XXL-JOB做定时任务、EasyExcel做导出几乎每个模块都有现成方案出了问题搜一下就能找到类似场景。对交付团队来说这意味着二次开发成本低。常见项目结构是controller接收参数、service写业务、mapper访问数据库新来的开发半天就能定位要改的服务。这也是中小企业和外包团队愿意选SpringBoot系ERP项目的原因——不是它技术最炫而是招人容易、资料全、改得动。版本选择上有一个常见分歧SpringBoot 2.7.x配JDK8或11是最普遍的组合教程多、中间件兼容性被踩平了SpringBoot 3.x必须JDK17javax改jakarta老代码迁移成本不小。我一般建议项目本身就是2.x起步不要为尝鲜升3.x从零部署且团队熟悉JDK17可以直接上3.x但要预留依赖兼容的排错时间。选2.x还是3.x在技术方案里就要定死别中途摇摆。2.3 “完全开源、永久免费”的代价边界省钱省在哪费事费在哪星云ERP把“完全开源、永久免费”写在定位里对买家来说是省了授权费但服务器、数据库、备份、安全补丁、故障响应都得自己扛。自助部署一套进销存系统最小投入是一台2核4G的云服务器加一个MySQL实例一个月几十块要做到高可用、自动备份、离线容灾成本会上去。算账的时候把运维成本算进去才是对“免费”的正确理解。个人或小团队跑业务用自部署完全够。开源协议的细节值得花半小时确认。进销存项目如果用了GPL类依赖做商业交付时可能要被要求开源衍生代码常见做法是优先选Apache 2.0或MIT授权的项目商用和私有化更从容。星云ERP的标题写“完全开源”实际交付前还是要以仓库里的LICENSE文件为准别听人一句“开源”就签了交付合同。最后是评估一个开源进销存项目值不值得投入看最近一年的提交频率和issue回复速度看文档里对部署步骤描述得是否具体看demo数据是否齐全。代码开源不等于项目活着一个三个月没人动的仓库再免费也不要接进生产环境。开源的价值是你能看得见代码、改得动逻辑但前提是它还在被维护。3. 用SpringBoot把星云ERP跑通从环境准备到第一张销售单3.1 版本组合与项目结构先把环境摆平星云ERP按常见做法是一个前后端分离项目后端SpringBoot前端Vue。推荐环境组合如下组件推荐版本说明JDK8 或 11SpringBoot 2.x 最常用3.x 必须 JDK17Maven3.6优先用项目自带 mvnw避免版本不一致MySQL5.7 或 8.0字符集用 utf8mb4Node.js14仅前端构建需要新手最容易在这步踩坑电脑里装了两个JDK环境变量指到旧版本启动日志里一堆UnsupportedClassVersionError。先执行java -version确认版本再执行mvn -v确认Maven用的是同一个JDK。拿到源码后先看目录结构典型的SpringBoot进销存项目长这样springboot-erp/ ├── pom.xml # Maven 依赖与构建配置 ├── mvnw / mvnw.cmd # Maven Wrapper自动下载指定版本 Maven ├── src/main/java/com/xxx/erp/ │ ├── ErpApplication.java # SpringBoot 启动类 │ ├── controller/ # 接收 HTTP 请求 │ ├── service/ # 业务逻辑订单、库存、报表 │ ├── mapper/ # MyBatis 数据访问接口 │ ├── entity/ # 数据库实体 │ ├── config/ # 安全、拦截器、全局异常 │ └── common/ # 返回结果封装、工具类 ├── src/main/resources/ │ ├── application.yml # 数据源、MyBatis、端口配置 │ ├── mapper/ # MyBatis XMLSQL │ └── db/ # init.sql 与 demo_data.sql └── frontend/ # Vue 前端工程controller-service-mapper三层是这个项目的骨架entity对应数据库表config里放权限拦截器和全局异常处理。如果项目里带frontend目录说明前后端分离如果resources/static下能看到打包好的前端文件说明可以直接打成一个jar运行二选一即可。3.2 修改数据库配置并初始化演示数据先把数据库建好。看db目录下init.sql和demo_data.sql的内容确认有没有CREATE DATABASE语句没有的话手动建库并把表的默认字符集设成utf8mb4不然中文和生僻字符容易出现乱码或排序问题。mysql -u root -p -e CREATE DATABASE erp_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p erp_db src/main/resources/db/init.sql mysql -u root -p erp_db src/main/resources/db/demo_data.sql用root建库没问题但application.yml里的应用账号建议单独建一个只给erp_db库的权限避免应用账号权限过大。数据初始化完成后打开src/main/resources/application.yml配置数据源和MyBatisserver: port: 8080 servlet: context-path: /erp # 访问前缀http://localhost:8080/erp spring: datasource: url: jdbc:mysql://localhost:3306/erp_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: erp_user password: erp_pass driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.erp.entityURL里的serverTimezoneAsia/Shanghai一定要加否则数据库时间和应用时间容易差8小时useSSLfalse避免本地调试时证书报错。driver-class-name在MySQL 8.x下固定是com.mysql.cj.jdbc.Driver如果你用的是5.7但也依赖了8.x驱动这个值不用改。MyBatis的mapper-locations指向classpath:mapper目录XML文件必须放在这个目录里否则启动后接口报Invalid bound statement。3.3 启动SpringBoot应用并跑通第一张销售单启动方式分两种调试时用Maven直接启动部署时打jar跑。前者适合看控制台日志和热更新后者更接近生产环境。# 方式一Maven 直接启动调试用 ./mvnw spring-boot:run # 方式二打包后启动生产常见 ./mvnw clean package -DskipTests java -jar target/springboot-erp.jar如果项目带独立前端开发时会开两个端口前端3000后端8080。前端工程里的vue.config.js需要配proxy把/api开头的请求转发到后端否则跨域直接把浏览器搞崩溃// frontend/vue.config.js module.exports { devServer: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } };把前端启动起来后按这条最小路径验证系统可用登录系统进入商品档案新增两个SKU建一张采购入库单录入10件、单价20元并审核再建销售出库单出4件、售价30元并审核最后打开库存列表核对数量变成6、销售报表出现一笔120元的销售额。这个流程能走通说明商品、采购、销售、库存、报表五大模块的基础链路正常可以开始往深处调。4. 把进销存做厚成本核算、权限控制与统计口径4.1 采购入库后销售出库库存成本怎么算才不出错一个进销存系统最容易跟财务对不上账的地方就是出库成本。常见三种移动加权平均、先进先出、个别计价。Oracle ERP里有个PAC成本法的概念本质是标准成本和实际成本的差异分摊中小企业的进销存基本用不上。星云ERP这类项目一般默认移动加权平均公式是新成本原库存金额本次入库金额/原库存数量本次入库数量每次入库后成本自动刷新出库时用当前成本结转。优点是实现简单、接近真实成本缺点是成本会随每次采购价格波动。核心代码常见是这样的Service public class InventoryService { Transactional(rollbackFor Exception.class) public void receiveStock(Long warehouseId, Long productId, int qty, BigDecimal unitCost) { // 1. 行锁防止并发重复入库 ProductStock stock productStockMapper.selectByWarehouseAndProductForUpdate(warehouseId, productId); // 2. 库存为0时直接采用本次入库价避免除零 if (stock.getQuantity() 0) { stock.setCostPrice(unitCost); } else { // 3. 移动加权平均总金额 / 总数量 BigDecimal totalAmount stock.getCostPrice() .multiply(BigDecimal.valueOf(stock.getQuantity())) .add(unitCost.multiply(BigDecimal.valueOf(qty))); int newQty stock.getQuantity() qty; stock.setCostPrice(totalAmount.divide(BigDecimal.valueOf(newQty), 4, RoundingMode.HALF_UP)); } // 4. 更新库存数量并写入库存流水 stock.setQuantity(stock.getQuantity() qty); productStockMapper.updateById(stock); inventoryLogMapper.insert(InventoryLog.build(stock, RECEIVE, qty)); } }注意三点一是selectByWarehouseAndProductForUpdate里的for update给行加了锁同一时间只有一个事务能改这一行防止并发重复入库二是金额计算用BigDecimal而不是double浮点数会出现0.10.2不等于0.3的问题三是除法保留四位小数、四舍五入避免成本价变成一长串小数。这里还有一个常见的门槛采购单价含税还是不含税要全公司统一。如果采购入库单录的是含税价销售出库成本就是含税成本毛利报表会偏高如果要做精细的进项税分离就要在商品档案里加“税率”字段在入库时拆出税额。中小企业常用做法是先按不含税价入库发票后到再走“采购发票”模块调整税额差异别把税算进成本里。4.2 权限模型和审计日志让管理透明而不是失控ERP实施工程师面试里常问权限模型怎么设计最常见的答案是RBAC用户→角色→权限。星云ERP这类系统在权限上一般分三层菜单权限控制能不能看到这个页面按钮权限控制能不能点“审核”“删除”数据权限控制这个账号只能看自己仓库的单据。把这套分清楚多店多仓的管理才能真正透明。用Spring Security做接口权限时常见写法是这样的http.authorizeRequests() .antMatchers(/api/user/login, /api/user/logout).permitAll() .antMatchers(/api/sale/**).hasAnyRole(SALE, ADMIN) .antMatchers(/api/report/**).hasAnyRole(FINANCE, ADMIN) .anyRequest().authenticated();菜单隐藏只是面子接口校验才是里子。前端把按钮藏起来没用懂技术的人直接调接口就绕过校验了所以后端每个接口必须做鉴权。另一个容易忽略的是审计日志库存调整、改价、删除单据、审批通过这几类高风险操作必须记录操作人、操作时间、操作对象、变更前后值。出了乱子时审计日志就是唯一后悔药。4.3 销售日报和库存报表先统一口径再画图表统计难不在SQL难写在口径。最典型纠纷是销售日报按创建时间、审核时间还是出库时间统计。常见做法是默认按审核时间因为草稿单不影响实际业务不能计进销售额。查询口径定好后SQL反而不复杂SELECT DATE(confirm_time) AS biz_date, COUNT(DISTINCT order_no) AS order_cnt, SUM(total_amount) AS sale_amount FROM sale_order WHERE status CONFIRMED AND confirm_time ? GROUP BY DATE(confirm_time) ORDER BY biz_date DESC;这段SQL的逻辑是只统计已审核订单按审核日期分组用DISTINCT去重订单号避免联表重复。total_amount建议存的是不含税金额报表里再单列一个税额字段前端展示时如果需要含税口径两者相加即可。库存周转率是另一个容易出错的地方公式是出库成本/[期初库存金额期末库存金额/2]分子用成本而不是售价否则周转次数虚高。报表性能是另一个常见坑。表数据量到了几十万行统计接口就开始慢。不要急着上复杂的报表引擎先把慢SQL拿出来看执行计划给order_no、confirm_time、product_id建上索引再把统计结果缓存到Redis最后才考虑引入独立报表库。中小企业这个量级把索引和缓存做好就够用了。5. 星云ERP实施避坑5个新手必踩的常见问题与排查5.1 启动就报Invalid bound statement (not found)现象SpringBoot启动没有任何问题一调用用户接口就报BindingException: Invalid bound statement (not found)。新手容易怀疑是框架坏了其实是MyBatis没找到SQL。原因Mapper接口和Mapper XML没建立映射。常见有三种XML文件没放在resources/mapper目录下XML的namespace和Mapper接口全限定名不一致application.yml里没配置mybatis.mapper-locations。解决按顺序检查三个位置。先看resources/mapper目录里有没有对应XML文件其次打开XML看namespace是不是com.xxx.erp.mapper.SaleOrderMapper这种完整路径最后确认application.yml里mybatis.mapper-locations是classpath:mapper/*.xml。改完执行mvn clean package重新打包用增量编译启动的话有可能旧class文件还在。5.2 数据库时间比北京时间早8小时现象单据列表里的时间显示为UTC时间比北京时间早8小时或者反过来晚了8小时。订单里只有时间对不上金额和数据都正常。原因三个环节的时区配置不一致。MySQL连接串没加serverTimezoneAsia/Shanghai应用所在服务器系统时区是UTCSpringBoot的Jackson序列化时区没设置。任何一个环节错了时间就歪。解决把三处统一。JDBC URL加serverTimezoneAsia/ShanghaiLinux服务器执行timedatectl set-timezone Asia/Shanghaiapplication.yml里spring.jackson.time-zone设成Asia/Shanghai。改完重启后新建一张单据看创建时间是否和本地时间一致别等月底报表时才发现全月对不上。5.3 销售出库后库存变成负数现象两个门店同时卖出同一款商品系统库存显示-5。财务对账时库存金额变成负数数据没法看。原因并发扣减时两个事务同时读到库存10都判断“够扣”各自扣8写回最终结果变成-6而不是2。这是典型的先查再改导致丢失更新没做行锁或原子更新。进销存系统里这是最严重的并发翻车点。解决两个方案叠加。业务层加Transactional和SELECT ... FOR UPDATE锁库存行SQL层用条件更新兜底一条语句完成判断和扣减UPDATE product_stock SET quantity quantity - #{qty} WHERE product_id #{productId} AND warehouse_id #{warehouseId} AND quantity #{qty}受影响行数为0说明库存不足直接抛异常回滚单据。这个SQL单独用也能防超卖但价格计算和日志写入还是要靠业务层事务统一。上线前先在系统设置里确认“允许负库存出库”开关是关闭的否则上面做的都白费。5.4 升级SpringBoot版本太高导致javax包全报红现象把项目从SpringBoot 2.x升到3.x编译时import javax.servlet.*、javax.validation.*全部报红看起来像依赖冲突换了几个包版本还是一样。原因SpringBoot 3基于Jakarta EE 9命名空间从javax迁移到jakarta。这是硬性变更不是依赖冲突靠换版本解决不了。解决全局搜索“import javax”逐个替换成“import jakarta”。注意藏在JSP标签、Filter、Interceptor、注解里的引用也要一起改不能漏。换完之后检查第三方依赖有没有兼容Jakarta的版本比如某些老的starter只支持javax这时要么找替代包要么放弃升级。我的习惯是项目一旦跑稳不轻易动SpringBoot大版本。5.5 前端打包后页面白屏、接口全走不通现象本地开发前后端联调正常npm run build之后把dist目录放进SpringBoot的static目录打开页面能看到空壳所有接口返回401或404。原因开发环境靠vue.config.js的proxy转发请求打包后变成静态文件直连后端接口前缀没对上。另一个可能是Vue Router用了history模式非首页刷新时后端没有匹配路由直接404。解决统一接口前缀前端axios的baseURL配成/api后端controller统一挂在/api路径下context-path去掉或者保持一致不要让前缀叠加。路由用了history模式的话后端加一个转发规则非/api请求全部转发到index.html。简单起见用hash模式可以省掉这一步。重新打包后如果还有问题用浏览器F12看network里实际请求的URL和后端路由是否一致。6. 星云ERP进阶一技月底结账前的账实核对与自动备份6.1 用盘点单做账实核对结果别等月底才后悔我养成了一个习惯进销存系统上线第一周每天下班前让库管在系统里开一张盘点单账面数自动带出实盘数扫实物填进去系统生成差异明细。这个动作真正的价值不是盘出差异而是尽早暴露流程缺口——采购入库漏审、出库单重复提交、期初库存录错都会在盘点差异里现形。差异超过50件或500元时强制填原因才能提交审核这个阈值在系统设置里可以调。6.2 数据库备份脚本给自己留后悔药备份脚本越简单越好重点是要能定期跑。下面这段是我常用的MySQL备份脚本每天凌晨2点执行#!/bin/bash BACKUP_DIR/data/backup/erp mkdir -p ${BACKUP_DIR} DATE$(date %Y%m%d_%H%M%S) mysqldump -u erp_user -pErp_Pass_2024 --single-transaction --routines --triggers erp_db ${BACKUP_DIR}/erp_${DATE}.sql find ${BACKUP_DIR} -name erp_*.sql -mtime 7 -delete--single-transaction对InnoDB表做一致快照备份不锁业务表--routines和--triggers把存储过程和触发器一起带上否则恢复后功能不完整。crontab配一行0 2 * * * /data/scripts/backup_erp.sh备份文件保留7天。再往后要求高一点把备份文件同步到对象存储或另一台机器防止服务器整台损坏时备份跟着丢。我刚帮人上线ERP那阵子吃过一次亏一天深夜客户打电话说库存乱了我登录一看前一天有人用管理账号把一张大宗销售单删了系统里找不到痕迹库房已经按那张单发了货。从那以后我所有项目第一个做的是定统计口径第二个就是把备份脚本挂上第三个是给管理员操作加审计日志。这些事看起来不产生业务功能但真出事的时候它们比什么功能都值钱。希望你上线前先把备份和盘点这两件事做了希望帮到你。本文还有配套的精品资源点击获取 SpringBoot进销存ERP实战：部署、成本核算与避坑指南
简介星云ERP是一套基于SpringBoot的中小企业进销存管理系统完全开源且永久免费专为小微型商贸与零售企业设计旨在通过线上化、透明化的业务流程解决开店、日常管理和数据统计难等痛点。整个资源包共包含1202个文件以Java源码1056个为核心辅以XML/YAML配置、SQL数据库脚本、FTL页面模板、Shell脚本及Dockerfile等压缩包整体大小仅1.44MB其中SQL脚本用于初始化业务数据Dockerfile支持容器化部署方便在本地或服务器环境快速启动。目前已有363人浏览学习非常适合中小企业管理者、Java开发工程师以及运维人员参考学习。资源完整覆盖基础信息、商品、采购、销售、零售、库存、盘点、结算等模块同时支持部门、角色和权限精细化管理多数业务参数均可配置贴合实际经营场景。借助Lombok配置减少重复编码结合可扩展的工程结构开发者能快速进行二次开发将系统落地为一套适合自身业务的企业级ERP平台。1. 星云ERP是什么一个SpringBoot进销存项目为什么值得你花一个下午跑通一家五金店的老板跟我算过一笔账五个员工、三个仓库每天开十几张出入库单账却全靠Excel月底对账要熬三个晚上最后发现一款螺丝账面300盒仓库里空得能跑老鼠。这种场景需要的不是一套上万元的商业ERP而是星云ERP这类基于SpringBoot框架、为中小企业做的完全开源、永久免费的进销存ERP系统。它把采购、销售、库存、数据统计收进同一套流程解决开店难、管理难、统计难让业务线上化、透明化、简易化。适合两类人被表格折磨的老板和店长以及需要给客户快速交付进销存系统的技术团队。2. 为什么中小企业上ERP总翻车从“开店难、管理难、统计难”倒推选型理由2.1 进销存管的是什么三个“难”字背后的业务闭环开店难的第一道坎不是缺钱是商品档案和价格体系没有固化。今天A记的是含税进价明天B记的是不含税进价月底一汇总毛利率忽高忽低说不出是供应商涨了价还是有人录错数。进销存的第一步是把商品、分类、单位、条形码、默认进价、默认售价、库存上下限这些主数据固定成表单让所有单据只能引用、不能随手乱写。很多ERP项目翻车不是软件不行是主数据在源头就没管住——业务线上化的前提是数据先标准化。管理难难在单据流转和责任边界。采购员开采购单库管员入库销售员开销售单谁经手就要在系统里留痕反过来一张销售单从下单到出库要经过审核、拣货、复核每一步卡住都要有明确提示。没有这套流程线上化只是把Excel搬进网页该扯皮还是扯皮。星云ERP这类进销存系统价值最大的地方是把“谁在什么时候做了什么动作”变成可追溯的数据而不是靠喊几嗓子。统计难表面看是缺报表本质是口径不统一。同一个月的销售额老板按订单日期算业务员按出库日期算财务按发票日期算谁都没错但数字就是对不上。进销存项目上线前必须先跟老板确认主营报表的口径是看开单、出库还是回款。常见做法是默认按单据审核时间出数再提供出库时间和回款时间两套可配置口径报表页面上做成下拉选择。把一个典型的中小贸易公司的流程拉直就是一条主线商品与供应商档案→采购订单→采购入库→库存增加→销售订单→销售出库→库存减少→盘点修正→报表统计。这条主线里采购和销售是两端库存是中间状态报表是最终出口。判断一个进销存项目靠不靠谱就沿着这条主线走一遍看每个环节的单据状态、库存变化和金额结转能不能闭环。2.2 为什么选SpringBoot做进销存ERP第二天就能改需求才是关键进销存ERP的业务规则重。一张销售单的状态机新建、已审核、已出库、已退货、库存扣减的并发控制、成本计算的精度这些都需要在一个成熟的编程模型里收敛。SpringBoot自带的Spring框架提供了声明式事务一个Transactional注解就能把库存扣减和单据状态更新放进同一事务失败一起回滚。这一点在PHP或Node工程里要靠自己搭不少基础设施一旦处理不当就会出现“单子成功、库存没减”这种让开发给客户赔笑脸的脏数据。SpringBoot在国内的生态积累也实在。MyBatis或MyBatis-Plus做持久层、Spring Security或Sa-Token做权限、XXL-JOB做定时任务、EasyExcel做导出几乎每个模块都有现成方案出了问题搜一下就能找到类似场景。对交付团队来说这意味着二次开发成本低。常见项目结构是controller接收参数、service写业务、mapper访问数据库新来的开发半天就能定位要改的服务。这也是中小企业和外包团队愿意选SpringBoot系ERP项目的原因——不是它技术最炫而是招人容易、资料全、改得动。版本选择上有一个常见分歧SpringBoot 2.7.x配JDK8或11是最普遍的组合教程多、中间件兼容性被踩平了SpringBoot 3.x必须JDK17javax改jakarta老代码迁移成本不小。我一般建议项目本身就是2.x起步不要为尝鲜升3.x从零部署且团队熟悉JDK17可以直接上3.x但要预留依赖兼容的排错时间。选2.x还是3.x在技术方案里就要定死别中途摇摆。2.3 “完全开源、永久免费”的代价边界省钱省在哪费事费在哪星云ERP把“完全开源、永久免费”写在定位里对买家来说是省了授权费但服务器、数据库、备份、安全补丁、故障响应都得自己扛。自助部署一套进销存系统最小投入是一台2核4G的云服务器加一个MySQL实例一个月几十块要做到高可用、自动备份、离线容灾成本会上去。算账的时候把运维成本算进去才是对“免费”的正确理解。个人或小团队跑业务用自部署完全够。开源协议的细节值得花半小时确认。进销存项目如果用了GPL类依赖做商业交付时可能要被要求开源衍生代码常见做法是优先选Apache 2.0或MIT授权的项目商用和私有化更从容。星云ERP的标题写“完全开源”实际交付前还是要以仓库里的LICENSE文件为准别听人一句“开源”就签了交付合同。最后是评估一个开源进销存项目值不值得投入看最近一年的提交频率和issue回复速度看文档里对部署步骤描述得是否具体看demo数据是否齐全。代码开源不等于项目活着一个三个月没人动的仓库再免费也不要接进生产环境。开源的价值是你能看得见代码、改得动逻辑但前提是它还在被维护。3. 用SpringBoot把星云ERP跑通从环境准备到第一张销售单3.1 版本组合与项目结构先把环境摆平星云ERP按常见做法是一个前后端分离项目后端SpringBoot前端Vue。推荐环境组合如下组件推荐版本说明JDK8 或 11SpringBoot 2.x 最常用3.x 必须 JDK17Maven3.6优先用项目自带 mvnw避免版本不一致MySQL5.7 或 8.0字符集用 utf8mb4Node.js14仅前端构建需要新手最容易在这步踩坑电脑里装了两个JDK环境变量指到旧版本启动日志里一堆UnsupportedClassVersionError。先执行java -version确认版本再执行mvn -v确认Maven用的是同一个JDK。拿到源码后先看目录结构典型的SpringBoot进销存项目长这样springboot-erp/ ├── pom.xml # Maven 依赖与构建配置 ├── mvnw / mvnw.cmd # Maven Wrapper自动下载指定版本 Maven ├── src/main/java/com/xxx/erp/ │ ├── ErpApplication.java # SpringBoot 启动类 │ ├── controller/ # 接收 HTTP 请求 │ ├── service/ # 业务逻辑订单、库存、报表 │ ├── mapper/ # MyBatis 数据访问接口 │ ├── entity/ # 数据库实体 │ ├── config/ # 安全、拦截器、全局异常 │ └── common/ # 返回结果封装、工具类 ├── src/main/resources/ │ ├── application.yml # 数据源、MyBatis、端口配置 │ ├── mapper/ # MyBatis XMLSQL │ └── db/ # init.sql 与 demo_data.sql └── frontend/ # Vue 前端工程controller-service-mapper三层是这个项目的骨架entity对应数据库表config里放权限拦截器和全局异常处理。如果项目里带frontend目录说明前后端分离如果resources/static下能看到打包好的前端文件说明可以直接打成一个jar运行二选一即可。3.2 修改数据库配置并初始化演示数据先把数据库建好。看db目录下init.sql和demo_data.sql的内容确认有没有CREATE DATABASE语句没有的话手动建库并把表的默认字符集设成utf8mb4不然中文和生僻字符容易出现乱码或排序问题。mysql -u root -p -e CREATE DATABASE erp_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p erp_db src/main/resources/db/init.sql mysql -u root -p erp_db src/main/resources/db/demo_data.sql用root建库没问题但application.yml里的应用账号建议单独建一个只给erp_db库的权限避免应用账号权限过大。数据初始化完成后打开src/main/resources/application.yml配置数据源和MyBatisserver: port: 8080 servlet: context-path: /erp # 访问前缀http://localhost:8080/erp spring: datasource: url: jdbc:mysql://localhost:3306/erp_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: erp_user password: erp_pass driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.erp.entityURL里的serverTimezoneAsia/Shanghai一定要加否则数据库时间和应用时间容易差8小时useSSLfalse避免本地调试时证书报错。driver-class-name在MySQL 8.x下固定是com.mysql.cj.jdbc.Driver如果你用的是5.7但也依赖了8.x驱动这个值不用改。MyBatis的mapper-locations指向classpath:mapper目录XML文件必须放在这个目录里否则启动后接口报Invalid bound statement。3.3 启动SpringBoot应用并跑通第一张销售单启动方式分两种调试时用Maven直接启动部署时打jar跑。前者适合看控制台日志和热更新后者更接近生产环境。# 方式一Maven 直接启动调试用 ./mvnw spring-boot:run # 方式二打包后启动生产常见 ./mvnw clean package -DskipTests java -jar target/springboot-erp.jar如果项目带独立前端开发时会开两个端口前端3000后端8080。前端工程里的vue.config.js需要配proxy把/api开头的请求转发到后端否则跨域直接把浏览器搞崩溃// frontend/vue.config.js module.exports { devServer: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } };把前端启动起来后按这条最小路径验证系统可用登录系统进入商品档案新增两个SKU建一张采购入库单录入10件、单价20元并审核再建销售出库单出4件、售价30元并审核最后打开库存列表核对数量变成6、销售报表出现一笔120元的销售额。这个流程能走通说明商品、采购、销售、库存、报表五大模块的基础链路正常可以开始往深处调。4. 把进销存做厚成本核算、权限控制与统计口径4.1 采购入库后销售出库库存成本怎么算才不出错一个进销存系统最容易跟财务对不上账的地方就是出库成本。常见三种移动加权平均、先进先出、个别计价。Oracle ERP里有个PAC成本法的概念本质是标准成本和实际成本的差异分摊中小企业的进销存基本用不上。星云ERP这类项目一般默认移动加权平均公式是新成本原库存金额本次入库金额/原库存数量本次入库数量每次入库后成本自动刷新出库时用当前成本结转。优点是实现简单、接近真实成本缺点是成本会随每次采购价格波动。核心代码常见是这样的Service public class InventoryService { Transactional(rollbackFor Exception.class) public void receiveStock(Long warehouseId, Long productId, int qty, BigDecimal unitCost) { // 1. 行锁防止并发重复入库 ProductStock stock productStockMapper.selectByWarehouseAndProductForUpdate(warehouseId, productId); // 2. 库存为0时直接采用本次入库价避免除零 if (stock.getQuantity() 0) { stock.setCostPrice(unitCost); } else { // 3. 移动加权平均总金额 / 总数量 BigDecimal totalAmount stock.getCostPrice() .multiply(BigDecimal.valueOf(stock.getQuantity())) .add(unitCost.multiply(BigDecimal.valueOf(qty))); int newQty stock.getQuantity() qty; stock.setCostPrice(totalAmount.divide(BigDecimal.valueOf(newQty), 4, RoundingMode.HALF_UP)); } // 4. 更新库存数量并写入库存流水 stock.setQuantity(stock.getQuantity() qty); productStockMapper.updateById(stock); inventoryLogMapper.insert(InventoryLog.build(stock, RECEIVE, qty)); } }注意三点一是selectByWarehouseAndProductForUpdate里的for update给行加了锁同一时间只有一个事务能改这一行防止并发重复入库二是金额计算用BigDecimal而不是double浮点数会出现0.10.2不等于0.3的问题三是除法保留四位小数、四舍五入避免成本价变成一长串小数。这里还有一个常见的门槛采购单价含税还是不含税要全公司统一。如果采购入库单录的是含税价销售出库成本就是含税成本毛利报表会偏高如果要做精细的进项税分离就要在商品档案里加“税率”字段在入库时拆出税额。中小企业常用做法是先按不含税价入库发票后到再走“采购发票”模块调整税额差异别把税算进成本里。4.2 权限模型和审计日志让管理透明而不是失控ERP实施工程师面试里常问权限模型怎么设计最常见的答案是RBAC用户→角色→权限。星云ERP这类系统在权限上一般分三层菜单权限控制能不能看到这个页面按钮权限控制能不能点“审核”“删除”数据权限控制这个账号只能看自己仓库的单据。把这套分清楚多店多仓的管理才能真正透明。用Spring Security做接口权限时常见写法是这样的http.authorizeRequests() .antMatchers(/api/user/login, /api/user/logout).permitAll() .antMatchers(/api/sale/**).hasAnyRole(SALE, ADMIN) .antMatchers(/api/report/**).hasAnyRole(FINANCE, ADMIN) .anyRequest().authenticated();菜单隐藏只是面子接口校验才是里子。前端把按钮藏起来没用懂技术的人直接调接口就绕过校验了所以后端每个接口必须做鉴权。另一个容易忽略的是审计日志库存调整、改价、删除单据、审批通过这几类高风险操作必须记录操作人、操作时间、操作对象、变更前后值。出了乱子时审计日志就是唯一后悔药。4.3 销售日报和库存报表先统一口径再画图表统计难不在SQL难写在口径。最典型纠纷是销售日报按创建时间、审核时间还是出库时间统计。常见做法是默认按审核时间因为草稿单不影响实际业务不能计进销售额。查询口径定好后SQL反而不复杂SELECT DATE(confirm_time) AS biz_date, COUNT(DISTINCT order_no) AS order_cnt, SUM(total_amount) AS sale_amount FROM sale_order WHERE status CONFIRMED AND confirm_time ? GROUP BY DATE(confirm_time) ORDER BY biz_date DESC;这段SQL的逻辑是只统计已审核订单按审核日期分组用DISTINCT去重订单号避免联表重复。total_amount建议存的是不含税金额报表里再单列一个税额字段前端展示时如果需要含税口径两者相加即可。库存周转率是另一个容易出错的地方公式是出库成本/[期初库存金额期末库存金额/2]分子用成本而不是售价否则周转次数虚高。报表性能是另一个常见坑。表数据量到了几十万行统计接口就开始慢。不要急着上复杂的报表引擎先把慢SQL拿出来看执行计划给order_no、confirm_time、product_id建上索引再把统计结果缓存到Redis最后才考虑引入独立报表库。中小企业这个量级把索引和缓存做好就够用了。5. 星云ERP实施避坑5个新手必踩的常见问题与排查5.1 启动就报Invalid bound statement (not found)现象SpringBoot启动没有任何问题一调用用户接口就报BindingException: Invalid bound statement (not found)。新手容易怀疑是框架坏了其实是MyBatis没找到SQL。原因Mapper接口和Mapper XML没建立映射。常见有三种XML文件没放在resources/mapper目录下XML的namespace和Mapper接口全限定名不一致application.yml里没配置mybatis.mapper-locations。解决按顺序检查三个位置。先看resources/mapper目录里有没有对应XML文件其次打开XML看namespace是不是com.xxx.erp.mapper.SaleOrderMapper这种完整路径最后确认application.yml里mybatis.mapper-locations是classpath:mapper/*.xml。改完执行mvn clean package重新打包用增量编译启动的话有可能旧class文件还在。5.2 数据库时间比北京时间早8小时现象单据列表里的时间显示为UTC时间比北京时间早8小时或者反过来晚了8小时。订单里只有时间对不上金额和数据都正常。原因三个环节的时区配置不一致。MySQL连接串没加serverTimezoneAsia/Shanghai应用所在服务器系统时区是UTCSpringBoot的Jackson序列化时区没设置。任何一个环节错了时间就歪。解决把三处统一。JDBC URL加serverTimezoneAsia/ShanghaiLinux服务器执行timedatectl set-timezone Asia/Shanghaiapplication.yml里spring.jackson.time-zone设成Asia/Shanghai。改完重启后新建一张单据看创建时间是否和本地时间一致别等月底报表时才发现全月对不上。5.3 销售出库后库存变成负数现象两个门店同时卖出同一款商品系统库存显示-5。财务对账时库存金额变成负数数据没法看。原因并发扣减时两个事务同时读到库存10都判断“够扣”各自扣8写回最终结果变成-6而不是2。这是典型的先查再改导致丢失更新没做行锁或原子更新。进销存系统里这是最严重的并发翻车点。解决两个方案叠加。业务层加Transactional和SELECT ... FOR UPDATE锁库存行SQL层用条件更新兜底一条语句完成判断和扣减UPDATE product_stock SET quantity quantity - #{qty} WHERE product_id #{productId} AND warehouse_id #{warehouseId} AND quantity #{qty}受影响行数为0说明库存不足直接抛异常回滚单据。这个SQL单独用也能防超卖但价格计算和日志写入还是要靠业务层事务统一。上线前先在系统设置里确认“允许负库存出库”开关是关闭的否则上面做的都白费。5.4 升级SpringBoot版本太高导致javax包全报红现象把项目从SpringBoot 2.x升到3.x编译时import javax.servlet.*、javax.validation.*全部报红看起来像依赖冲突换了几个包版本还是一样。原因SpringBoot 3基于Jakarta EE 9命名空间从javax迁移到jakarta。这是硬性变更不是依赖冲突靠换版本解决不了。解决全局搜索“import javax”逐个替换成“import jakarta”。注意藏在JSP标签、Filter、Interceptor、注解里的引用也要一起改不能漏。换完之后检查第三方依赖有没有兼容Jakarta的版本比如某些老的starter只支持javax这时要么找替代包要么放弃升级。我的习惯是项目一旦跑稳不轻易动SpringBoot大版本。5.5 前端打包后页面白屏、接口全走不通现象本地开发前后端联调正常npm run build之后把dist目录放进SpringBoot的static目录打开页面能看到空壳所有接口返回401或404。原因开发环境靠vue.config.js的proxy转发请求打包后变成静态文件直连后端接口前缀没对上。另一个可能是Vue Router用了history模式非首页刷新时后端没有匹配路由直接404。解决统一接口前缀前端axios的baseURL配成/api后端controller统一挂在/api路径下context-path去掉或者保持一致不要让前缀叠加。路由用了history模式的话后端加一个转发规则非/api请求全部转发到index.html。简单起见用hash模式可以省掉这一步。重新打包后如果还有问题用浏览器F12看network里实际请求的URL和后端路由是否一致。6. 星云ERP进阶一技月底结账前的账实核对与自动备份6.1 用盘点单做账实核对结果别等月底才后悔我养成了一个习惯进销存系统上线第一周每天下班前让库管在系统里开一张盘点单账面数自动带出实盘数扫实物填进去系统生成差异明细。这个动作真正的价值不是盘出差异而是尽早暴露流程缺口——采购入库漏审、出库单重复提交、期初库存录错都会在盘点差异里现形。差异超过50件或500元时强制填原因才能提交审核这个阈值在系统设置里可以调。6.2 数据库备份脚本给自己留后悔药备份脚本越简单越好重点是要能定期跑。下面这段是我常用的MySQL备份脚本每天凌晨2点执行#!/bin/bash BACKUP_DIR/data/backup/erp mkdir -p ${BACKUP_DIR} DATE$(date %Y%m%d_%H%M%S) mysqldump -u erp_user -pErp_Pass_2024 --single-transaction --routines --triggers erp_db ${BACKUP_DIR}/erp_${DATE}.sql find ${BACKUP_DIR} -name erp_*.sql -mtime 7 -delete--single-transaction对InnoDB表做一致快照备份不锁业务表--routines和--triggers把存储过程和触发器一起带上否则恢复后功能不完整。crontab配一行0 2 * * * /data/scripts/backup_erp.sh备份文件保留7天。再往后要求高一点把备份文件同步到对象存储或另一台机器防止服务器整台损坏时备份跟着丢。我刚帮人上线ERP那阵子吃过一次亏一天深夜客户打电话说库存乱了我登录一看前一天有人用管理账号把一张大宗销售单删了系统里找不到痕迹库房已经按那张单发了货。从那以后我所有项目第一个做的是定统计口径第二个就是把备份脚本挂上第三个是给管理员操作加审计日志。这些事看起来不产生业务功能但真出事的时候它们比什么功能都值钱。希望你上线前先把备份和盘点这两件事做了希望帮到你。本文还有配套的精品资源点击获取