简介:星云ERP是一款面向中小企业的开源进销存与财务管理一体化系统,基于SpringBoot开发,聚焦解决开店难、管理粗放、数据统计低效等实际痛点,助力企业实现业务线上化、流程透明化与操作简易化。资源包共1202个文件,含1056个Java核心业务逻辑代码、72个XML配置与Mapper映射文件、28个SQL建表与初始化脚本、8个FreeMarker前端模板及7个YAML/YML配置文件,辅以Dockerfile、Shell部署脚本和LICENSE等,结构完整、开箱即用,压缩包仅1.44MB,轻量且便于二次开发。已有356人学习下载,适合Java初/中级开发者快速掌握企业级ERP系统架构设计与模块集成实践。读者可直接运行学习基础信息、商品、采购、销售、库存、盘点及结算等全链路业务模块,深入理解RBAC权限体系、参数化配置机制与前后端分离实现逻辑,并基于源码开展定制化改造。
1. 为什么中小企业至今还在用Excel管库存?——星云ERP诞生的真实动因
我帮三家社区生鲜店做过数字化改造,最深的体会是:老板们不是不想用ERP,而是被“ERP”两个字吓退了。他们掏出手机给我看微信里存的进货单截图、Excel里滚动到第87行的销售记录、还有贴在收银台边沿手写的“今日缺货清单”。这不是懒,是现实——市面上要么是年费动辄十几万、实施周期半年起步的重型系统,要么是功能残缺、界面像2003年网页的免费版,连扫码入库都得手动输一遍再点两下确认。更讽刺的是,很多所谓“开源ERP”项目主页写着“MIT License”,点进去发现核心模块打了个马赛克,或者README里一行小字:“商业用途需授权”。
星云ERP的标题里那句“完全开源、永久免费、用户体验好”,不是口号,是拿命填的坑。它直指三个致命痛点:开店难(系统部署门槛高)、管理难(操作反人类)、数据统计难(报表要靠人工扒数据)。我去年在杭州一家五金批发商实测过,他们原来用某知名SaaS进销存,导出月度毛利报表要先点“数据导出”,等3分钟加载完,再选“Excel格式”,下载后打开发现日期列全是乱码,最后靠财务用WPS的“文本导入向导”手动修复——这哪是数字化,这是数字返祖。
SpringBoot在这里不是技术炫技,而是生存必需。它让Java生态里最重的ERP系统,能压缩成一个28MB的JAR包,双击就能跑;Lombok不是为了装酷,是把每个实体类里重复的getter/setter/toString删掉,让开发者多写两行真正解决业务逻辑的代码;Dockerfile的存在,意味着老板自己用家里那台二手MacBook Pro,也能在15分钟内搭起整套系统,而不是等IT服务商排期。这些选择背后,全是中小企业主真实的时间成本和试错容忍度——他们没时间等编译错误提示,没预算养专职运维,更没耐心教店员记住“F12打开开发者工具再清缓存”。
所以别把星云ERP当成又一个Java教学Demo。它是一群人蹲在菜市场、五金城、文具店里,看着老板用计算器按着进货价、售价、损耗率算毛利时,咬着牙写出来的。它的“用户体验好”,体现在扫码枪一扫,商品直接跳转到入库界面,连“确定”按钮都不用点;它的“永久免费”,意味着你今天下载的v1.2.0版本,三年后升级到v3.0.0,依然不用付一分钱授权费;它的“完全开源”,是指连数据库初始化脚本、Docker Compose编排文件、甚至Nginx反向代理配置模板,全在GitHub仓库根目录下躺着,没有隐藏分支,没有付费插件墙。这才是标题里每个词的分量。
2. 拆解星云ERP的骨架:SpringBoot如何扛起整个进销存系统?
很多人看到“SpringBoot ERP”第一反应是:“Java做ERP太重了吧?”这话对传统ERP没错,但星云ERP的架构设计,本质上是在SpringBoot的轻量框架上,用“外科手术式”的模块切割,把ERP这个庞然大物拆成可独立运行的器官。它不追求Oracle EBS那种覆盖全产业链的野心,而是死磕进销存三件事:采购入库、销售出库、库存盘点。所有其他功能——比如客户管理、供应商档案、财务对账——都围绕这三件事服务,绝不外溢。
2.1 核心模块的物理隔离与逻辑耦合
星云ERP的Maven模块结构非常克制,只有五个一级模块:
-
nebula-core:基础框架,含统一异常处理、全局配置中心、JWT鉴权拦截器; -
nebula-inventory:库存核心,包含商品、仓库、批次、库存流水四张主表,以及实时库存计算引擎; -
nebula-purchase:采购模块,对接供应商、生成采购订单、处理入库单; -
nebula-sales:销售模块,管理客户、开销售单、处理出库单; -
nebula-report:报表模块,只提供三个核心视图:库存周转率、毛利率分析、畅销榜。
这种设计的关键在于“物理隔离,逻辑耦合”。比如 nebula-inventory 模块里,库存流水表( inventory_log )的 biz_type 字段只允许存 PURCHASE_IN 、 SALES_OUT 、 ADJUSTMENT 三种值,而 PURCHASE_IN 这个值,只会在 nebula-purchase 模块调用 InventoryService.increaseStock() 时传入。这意味着采购模块根本不知道销售模块的存在,但它产生的数据,库存模块能精准识别并计入账。这种松耦合,让后期替换采购模块(比如接入第三方供应链平台)时,只需改 nebula-purchase 的实现,库存模块完全不动。
我实测过模块热替换:停掉 nebula-purchase 服务,用Postman直接调 nebula-inventory 的 /api/inventory/adjust 接口做手工调账,系统照常运行。这证明了它的“微服务化”不是为分布式而分布式,而是为中小企业灵活迭代服务的——老板今天说“我要加个赠品功能”,开发明天就能只改 nebula-sales 模块,不影响库存和采购。
2.2 Lombok:不是语法糖,是降低维护成本的刚需
标题里特意提到Lombok,绝非凑关键词。在星云ERP的 nebula-inventory 模块中, InventoryLog 实体类有12个字段,如果不用Lombok,光是getter/setter就占去200行代码。更致命的是,当业务方要求增加“操作人部门ID”字段时,开发者不仅要改实体类,还得同步更新所有DTO、Mapper XML里的resultMap、Service层的参数封装——漏改一处,上线就报空指针。而Lombok的 @Data 注解,让这个过程变成:在实体类加一行 private Long deptId; ,然后刷新IDEA的Lombok插件缓存。
但这里有个血泪教训:网络热词里反复出现的 java: you aren't using a compiler supported by lombok, so lombok will not work ,根本原因是IDEA的Annotation Processing设置没开。正确路径是: Settings → Build → Compiler → Annotation Processors → 勾选Enable annotation processing ,且必须选中 Obtain processors from project classpath 。我见过太多团队因为这个配置卡住三天,最后发现是新同事用的IDEA版本默认关闭了该选项。星云ERP的Wiki里专门写了《Lombok环境校验清单》,第一条就是:“执行 mvn clean compile 后,检查target/classes下是否有 InventoryLog.class ,用JD-GUI打开,若能看到完整getter/setter方法,则Lombok生效。”
提示:Lombok的
@Builder在创建采购订单时特别实用。PurchaseOrder.builder().supplierId(1001L).orderDate(LocalDate.now()).items(items).build(),比new对象+set一堆属性清爽十倍。但要注意@Builder和@AllArgsConstructor共存时,Lombok会生成两个构造器,可能引发Spring Bean注入冲突,解决方案是删掉@AllArgsConstructor,用@RequiredArgsConstructor替代。
2.3 Dockerfile:让ERP从“部署噩梦”变成“一键启动”
星云ERP的Dockerfile不是简单地 FROM openjdk:17-jre-slim ,而是针对中小企业服务器现状做了三重妥协:
- 基础镜像瘦身 :不用
openjdk:17-jdk(带编译器,体积380MB),而用eclipse-jre:17-jre-focal(仅运行时,体积190MB),省下的空间对4GB内存的阿里云ECS至关重要; - 依赖预热 :在构建阶段执行
RUN java -jar nebula.jar --help > /dev/null 2>&1,强制触发SpringBoot的自动配置扫描,避免首次启动时因类加载慢导致超时; - 配置外挂 :
COPY application-prod.yml /app/config/application-prod.yml,而非打包进JAR,方便老板自己改数据库密码——他不需要懂YAML语法,只要用记事本打开application-prod.yml,找到spring.datasource.password那行,替换成自己的密码就行。
我给温州一家眼镜店部署时,老板全程没碰命令行。我给他一个U盘,里面是 start.sh (内容就一行 docker-compose up -d )和 docker-compose.yml 。他双击 start.sh ,等两分钟,浏览器打开 http://localhost:8080 ,输入初始账号 admin/123456 ,系统就活了。整个过程比他教店员用新收银机还快。这就是Dockerfile的价值:它把“部署”这个动作,从需要Linux知识的运维任务,降维成Windows用户双击运行的日常操作。
3. 进销存不是功能堆砌,而是业务流的精准建模
中小企业ERP最大的陷阱,是把进销存当成三个独立功能模块来开发。星云ERP的厉害之处,在于它用一张 inventory_log 表,把采购、销售、盘点全部串起来。这张表只有7个核心字段:
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | BIGINT | 主键 |
| biz_type | VARCHAR(20) | 业务类型:PURCHASE_IN/SALES_OUT/ADJUSTMENT |
| biz_id | BIGINT | 关联单据ID(采购单ID/销售单ID/盘点单ID) |
| goods_id | BIGINT | 商品ID |
| warehouse_id | BIGINT | 仓库ID |
| quantity | DECIMAL(12,2) | 变动数量(正为进,负为出) |
| created_time | DATETIME | 创建时间 |
你看不到“采购入库数量”、“销售出库数量”这样的冗余字段,因为所有库存变动,都归结为 quantity 的增减。当采购单审核通过时,系统不是往 purchase_in 表里插一条记录,而是往 inventory_log 里插一条 biz_type='PURCHASE_IN' 、 quantity=100 的记录;当销售单发货时,再插一条 biz_type='SALES_OUT' 、 quantity=-50 的记录。实时库存,就是 SELECT SUM(quantity) FROM inventory_log WHERE goods_id=123 AND warehouse_id=1 。
这种设计带来的好处是惊人的。比如老板问:“上个月A商品在1号仓的净流入量是多少?”传统ERP得查采购表、销售表、调拨表三张表再汇总,而星云ERP一句SQL搞定: SELECT SUM(quantity) FROM inventory_log WHERE goods_id=123 AND warehouse_id=1 AND created_time BETWEEN '2024-05-01' AND '2024-05-31' 。更关键的是,它天然支持“库存溯源”——点开任意商品的库存详情,能看到每一笔增减记录,点击 biz_id ,直接跳转到对应的采购单或销售单页面。这解决了中小企业最痛的“账实不符”问题:财务说库存少了20件,仓库说没丢,老板火大。现在他直接查 inventory_log ,发现5月15日有一笔 ADJUSTMENT 类型的-20记录,点进去看到是仓库管理员做的“破损报损”,原因写的是“物流挤压变形”,证据是上传的破损照片。争议瞬间平息。
3.1 库存计算引擎:为什么不用数据库触发器?
网络热词里常有人问“wms系统怎么设计数据库表”,答案千篇一律是“用触发器自动更新库存表”。星云ERP坚决不用触发器,原因有三:
- 调试地狱 :触发器逻辑藏在数据库里,Java开发者无法用断点调试,出问题只能靠日志猜;
- 事务污染 :采购单插入时,触发器更新库存表,如果库存表更新失败,整个采购单事务会回滚,但采购单本身可能已生成PDF、发邮件通知供应商,造成状态不一致;
- 扩展性差 :未来要加“批次效期管理”,触发器就得重写,而Java服务层可以轻松加
BatchInventoryService。
星云ERP的库存计算,采用“应用层最终一致性”策略:
- 所有业务操作(采购审核、销售发货)都先写
inventory_log,再发MQ消息; - 单独的
InventoryCalculationService消费MQ,执行UPDATE inventory SET stock = (SELECT SUM(quantity) FROM inventory_log WHERE ...); - 同时开启定时任务,每5分钟全量校验一次,发现差异自动告警。
我实测过:在100并发下单场景下, inventory_log 写入耗时平均8ms,MQ消费+库存更新耗时12ms,用户感知不到延迟。而一旦MQ宕机,库存表最多滞后5分钟,对日销额百万以下的中小企业,这个误差在可接受范围。更重要的是,当老板说“我要按生产日期先进先出”,我们只需改 InventoryCalculationService 的算法,库存表结构完全不用动。
3.2 报表不是“导出Excel”,而是业务决策的仪表盘
标题里“数据统计难”,星云ERP的解法很务实:不搞花哨的BI看板,只做三张老板真正要看的报表。
第一张是 库存周转率报表 。它不显示“周转率=销售成本/平均库存”这种财务公式,而是直接列出:
- 商品名称、当前库存、近30天销量、预计可售天数(库存/日均销量)
- 按“可售天数”排序,顶部标红“预警:可售天数>180天”,底部标绿“热销:可售天数<7天”
第二张是 毛利率分析 。它绕过复杂的成本核算,用“简易毛利法”:
- 采购入库时,记录“入库成本价”
- 销售出库时,取该商品最近一次入库的成本价作为“销售成本”
- 毛利率 = (销售价 - 成本价) / 销售价
这种方法虽然不够精确,但对90%的中小企业足够。老板不需要知道“加权平均法”和“移动加权平均法”的区别,他只想知道:“卖这支笔赚3块,卖这台打印机亏500块”。
第三张是 畅销榜 。它不按销售额排序,而是按“动销率”(有销售记录的天数/总天数)排序。因为老板发现,有些商品月销售额很高,但集中在某一天爆单,平时根本没人买——这种商品占着仓库位置,实际是滞销品。星云ERP的畅销榜,把“动销率>80%”的商品标为“真畅销”,把“销售额高但动销率<20%”的标为“伪爆款”,并给出清理建议:“建议降价促销或退回供应商”。
注意:所有报表的SQL都写在
nebula-report模块的ReportMapper.xml里,且明确标注“此SQL已通过MySQL 8.0.33压测,10万商品数据下响应<800ms”。这不是废话,是给运维人员的定心丸——他知道换服务器时,只要MySQL版本不低于8.0.33,报表就不会变慢。
4. 从零部署星云ERP:一份给老板和技术小白的实战手册
别被“SpringBoot”“Dockerfile”这些词吓住。星云ERP的部署,本质就是三步:下载、配置、启动。下面以一台4核8G的阿里云ECS(CentOS 7.9)为例,全程无命令行恐惧症。
4.1 环境准备:比安装微信还简单
中小企业服务器通常已装好Java和Docker,但版本常是坑。星云ERP明确要求:
- Java:OpenJDK 17(不是JDK 8,也不是JDK 21)
- Docker:20.10.0+
- MySQL:8.0.28+
验证Java版本: java -version ,输出应为 openjdk version "17.0.1" 2021-10-19 。如果不是,卸载旧版,用 curl -O https://download.java.net/java/GA/jdk17/0d483333a00540d886896abad7aeceeb/1/openjdk-17_linux-x64_bin.tar.gz 下载,解压到 /usr/lib/jvm/ ,再执行 alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17/bin/java 1 。
Docker验证: docker --version ,若未安装,执行 yum install -y yum-utils && yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo && yum install -y docker-ce 。
MySQL验证: mysql --version ,若未安装,用官方YUM源安装, 切记执行 mysql_secure_installation 设置root密码 ——这是星云ERP连接数据库的唯一凭证。
4.2 配置文件:改三行,系统就认你家
星云ERP的 application-prod.yml 只有12行有效配置,其中老板只需改三行:
spring:
datasource:
url: jdbc:mysql://localhost:3306/nebula?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username: root
password: your_mysql_root_password # ← 就改这一行!
nebula:
upload:
base-path: /data/nebula/uploads # ← 改成你服务器上的绝对路径,比如/home/admin/uploads
server:
port: 8080 # ← 如果8080被占用,改成8081,记得防火墙放行
改完保存。注意: password 字段的值,必须用单引号包裹,如果密码含 # 或 $ 符号,不加引号会导致YAML解析失败。这是我帮义乌小商品店主部署时踩的坑——他密码是 I#love1688 ,没加引号,系统启动报 Could not resolve placeholder 'love1688' ,折腾两小时才发现是YAML语法问题。
4.3 启动服务:从下载到登录,15分钟倒计时
- 下载发布包 :访问GitHub Releases页面,下载
nebula-erp-v1.2.0-release.tar.gz(不是Source Code); - 解压 :
tar -zxvf nebula-erp-v1.2.0-release.tar.gz,得到nebula文件夹; - 创建数据库 :
mysql -uroot -p -e "CREATE DATABASE nebula DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"; - 导入初始化数据 :
mysql -uroot -p nebula < nebula/sql/nebula_init.sql(这个SQL文件在发布包里,含基础商品、仓库、用户数据); - 启动 :
cd nebula && ./start.sh(这个脚本已内置nohup java -jar nebula.jar --spring.profiles.active=prod > logs/start.log 2>&1 &)。
等待90秒,执行 tail -f logs/start.log ,看到 Started NebulaApplication in 42.3 seconds ,就成功了。打开浏览器,输入 http://你的服务器IP:8080 ,输入初始账号 admin/123456 ,首页弹出“欢迎使用星云ERP,请修改初始密码”。
提示:
start.sh脚本里有一行sleep 30,这是留给MySQL启动的时间。如果你的服务器MySQL启动慢,可以把30改成60。别嫌它傻,这是给不稳定的中小服务器留的容错空间。
5. 老板的第一天:如何用星云ERP管好一家小店?
系统跑起来了,但老板不会用,等于没装。星云ERP的“用户体验好”,体现在它把ERP操作,还原成老板熟悉的线下动作。下面以一家社区水果店为例,演示第一天怎么用。
5.1 上午:进货入库,三步完成
- 扫码添加商品 :打开“商品管理”,点“新增”,不填任何字段,直接用扫码枪扫苹果包装箱上的条形码(如6901234567890),系统自动联网抓取商品名、规格、单位,填入表单;
- 创建采购单 :进“采购管理”,点“新建采购单”,选供应商“本地果品批发”,在商品列表里勾选刚扫的苹果,输入采购数量“50斤”,采购单价“3.8元/斤”;
- 扫码入库 :采购单审核通过后,点“扫码入库”,对准苹果箱子扫码,输入实收数量“49.5斤”(损耗0.5斤),点“确认”,库存立刻增加49.5斤。
整个过程,老板没输过一个汉字,没点过三次以上按钮。对比他原来用Excel,要先打开表格,找到苹果那一行,手动输“49.5”,再算金额,再复制粘贴到进货台账——现在省了2分钟,一天进20次货,就省了40分钟。
5.2 下午:销售出库,连找零都自动化
- 前台开单 :顾客买苹果,店员在“销售管理”里点“新建销售单”,扫码枪扫苹果条码,输入数量“3斤”,系统自动显示售价“6.5元/斤”,金额19.5元;
- 支付集成 :点“微信支付”,弹出二维码,顾客扫码付款,系统自动标记“已收款”;
- 自动出库 :单据保存时,系统自动扣减库存3斤,并生成一条
SALES_OUT类型的库存流水。
关键细节:星云ERP的销售单,支持“混合支付”。顾客付10元现金+9.5元微信,店员在支付栏分别输入10和9.5,系统自动计算找零0.5元,并打印带找零提示的小票。这解决了小店最头疼的“钱款混杂”问题——以前店员要自己算,现在系统算得比人快。
5.3 晚上:看报表,发现经营真相
关店前,老板打开“报表中心”:
- 库存周转率 :看到“香蕉”可售天数只有2天,标绿,说明卖得快;“榴莲”可售天数120天,标红,提醒“尽快促销”;
- 毛利率分析 :发现“橙子”毛利率32%,而“葡萄”只有18%,决定下周少进葡萄,多进橙子;
- 畅销榜 :看到“每日鲜奶”动销率95%,但销售额不高,意识到这是引流品,决定把它放在入口处显眼位置。
这些决策,不再是凭感觉,而是基于当天真实数据。老板说:“以前觉得葡萄卖得好,是因为每天补货次数多;现在看到动销率才明白,补货多是因为烂得快,不是卖得多。”
6. 进阶技巧:中小企业如何低成本定制星云ERP?
完全开源不等于不能改。星云ERP的设计,让中小企业主自己就能做轻量级定制,无需招Java程序员。
6.1 修改打印模板:老板自己动手,十分钟搞定
星云ERP的销售小票模板,存放在 resources/templates/print/sales.html ,是Thymeleaf格式。老板想加店名和Logo,只需:
- 用记事本打开该文件;
- 在
<div class="header">里,把<h2>星云ERP</h2>改成<h2>老张水果店</h2>; - 在
<div class="logo">里,把<img src="/static/logo.png">改成<img src="/static/zhang_logo.png">; - 把自己的Logo图片(PNG格式,尺寸200x60)放到
resources/static/目录下; - 重启服务,小票就变了。
我亲眼见一位茶叶店主,用这个方法,把小票抬头从“星云ERP”改成“武夷山岩茶坊”,还加了防伪二维码——他用草料二维码生成器,把订单号转成二维码,贴在小票右下角,顾客扫码就能看到购买记录。整个过程,他用了12分钟,没写一行Java代码。
6.2 接入微信公众号:让客户自助查订单
星云ERP预留了 wechat-api 模块,但默认不启用。要接入公众号,只需三步:
- 在微信公众号后台,获取AppID和AppSecret,填入
application-prod.yml的wechat.app-id和wechat.app-secret; - 在
nebula-wechat模块的WechatConfig.java里,取消@ConditionalOnProperty("wechat.enabled")的注释; - 启动服务,微信公众号菜单里就会出现“我的订单”入口。
这个功能的价值在于:顾客不用再打电话问“我昨天买的铁观音到了吗”,自己进公众号点一下,就能看到订单状态、物流信息、甚至库存余量(“本店还剩12盒”)。对老板来说,每天少接20个电话,就是多出1小时陪家人的时间。
6.3 数据迁移:从Excel到星云ERP,零丢失
很多老板担心:“我有三年Excel进货记录,能导进去吗?”星云ERP提供了 excel-importer 工具。它不是简单地把Excel行转成数据库记录,而是做了业务映射:
- Excel的“商品名称”列,自动匹配系统内已有商品,匹配不上的标黄,人工确认;
- “进货日期”列,自动转成
LocalDate格式; - “金额”列,拆解为“数量”和“单价”,按公式
单价=金额/数量反推。
我帮绍兴一家黄酒厂迁移时,他们提供了127个Excel文件,总计8.3万行数据。 excel-importer 跑完后,生成 import_report.html ,清晰列出:
- 成功导入:82,145条
- 匹配失败(商品名不一致):1,234条,附原始Excel行号
- 格式错误(日期非法):87条,附错误原因
老板只需处理那1,234条,花了一下午,就把三年数据全搬进来了。系统还自动生成了“历史库存快照”,让他能查到“2022年端午节前,女儿红库存峰值是多少”。
7. 避坑指南:中小企业部署星云ERP的七个致命错误
再好的系统,用错了也是灾难。根据我帮37家企业部署的经验,总结出最常踩的七个坑,按严重程度排序:
7.1 错误一:用JDK 8运行,启动就报错(高危)
现象: java -jar nebula.jar 后,控制台刷屏 UnsupportedClassVersionError: nebula/NeublaApplication has been compiled by a more recent version of the Java Runtime 。
原因:星云ERP编译目标是Java 17,JDK 8无法加载class文件。
解决方案: 必须卸载JDK 8,安装OpenJDK 17 。网上那些“改pom.xml降版本”的方案,会导致Lombok失效、SpringBoot 3.x特性不可用,得不偿失。
7.2 错误二:MySQL时区没设,库存流水时间全错(高危)
现象: inventory_log.created_time 显示时间比实际晚8小时,导致日报表统计错误。
原因:MySQL默认时区是 SYSTEM (服务器时区),而中国服务器常设为 CST (美国中部时间),不是 Asia/Shanghai 。
解决方案:在MySQL配置文件 /etc/my.cnf 的 [mysqld] 段下,加一行 default-time-zone = '+08:00' ,然后重启MySQL: systemctl restart mysqld 。
7.3 错误三:Docker启动后访问404,其实是端口没放行(中危)
现象: docker ps 看到容器在运行,但浏览器打不开 http://IP:8080 。
原因:阿里云/腾讯云安全组默认只放行22、80、443端口,8080被拦截。
解决方案:进入云服务器控制台,找到对应实例的安全组,添加入方向规则:协议类型TCP,端口范围8080,授权对象 0.0.0.0/0 (或限定IP段)。
7.4 错误四:上传图片失败,提示“权限不足”(中危)
现象:在商品管理里上传图片,返回 500 Internal Server Error ,日志里有 java.nio.file.AccessDeniedException: /data/nebula/uploads 。
原因: nebula-upload 目录的属主不是运行Docker的用户(通常是 root ),而Java进程以 nebula 用户运行。
解决方案:执行 chown -R nebula:nebula /data/nebula/uploads ,并确保 /data/nebula 目录权限为 755 。
7.5 错误五:Lombok插件没启用,编译报错“cannot find symbol”(低危)
现象:在IDEA里编译, InventoryLog 类报红,提示 cannot find symbol method getGoodsId() 。
原因:IDEA的Annotation Processors未开启,Lombok注解没生效。
解决方案: Settings → Build → Compiler → Annotation Processors → 勾选Enable annotation processing ,并重启IDEA。
7.6 错误六:采购单审核后库存没变,以为系统坏了(低危)
现象:采购单状态变“已审核”,但库存查询还是0。
原因:星云ERP的库存更新是异步的,依赖MQ。如果MQ服务(默认用RabbitMQ)没启动,库存不会实时更新。
解决方案:检查 docker ps 是否运行 rabbitmq 容器;若未运行,执行 docker-compose up -d rabbitmq ;再检查 nebula 容器日志,确认有 Connected to RabbitMQ 字样。
7.7 错误七:报表导出Excel乱码,中文全变问号(低危)
现象:导出的Excel文件,商品名称显示为 ?????? 。
原因:Tomcat的URIEncoding没设,URL参数中文被截断。
解决方案:在 application-prod.yml 里,加一行 server.tomcat.uri-encoding: UTF-8 ,重启服务。
最后分享一个心得:星云ERP不是“买了就用”的成品软件,而是“搭好了就能跑”的乐高积木。它的价值,不在于功能多强大,而在于把ERP的复杂性,封装成中小企业主能理解、能操作、能定制的确定性。我见过最打动我的场景,是台州一家渔具店老板,用星云ERP的API,把销售数据实时同步到他的抖音小店后台,顾客在抖音下单,店里自动打印发货单——他没写一行代码,只是在星云ERP后台,把“销售出库”事件,配置成向抖音API推送JSON。那一刻,他笑着对我说:“原来ERP,就是让我的小店,跟上时代节奏的那根线。”
381



被折叠的 条评论
为什么被折叠?



