从零开始：程序员如何搭建一套自动仓储管理系统

作为一个程序员，我最初对”自动仓储”的认知来自于科幻电影——机器人穿梭在货架间，精准地取放货物。直到一个客户问我”能不能做一套自动仓储管理系统”，我才开始认真研究这个领域。

经过一段时间的摸索，我发现这个领域并没有想象中那么神秘。本质上，这就是一套”业务系统 + 自动化设备”的组合，而作为程序员，我们的优势在于能够快速理解系统架构、掌握开源方案、甚至自己写代码来对接硬件。

这篇文章是我从零开始学习、搭建、思考的全过程记录，希望能给同样想进入这个领域的程序员朋友一些参考。

全文约 2 万字，建议先收藏，分次阅读。

第一部分：先搞懂”自动仓储”到底是什么

1.1 一个公式理解核心

在深入之前，先记住一个公式：

WMS（仓库管理系统）+ 自动化硬件 = 自动仓储管理系统

• WMS：大脑，负责思考、决策、记录。管的是信息流（库存、订单、货位）
• 自动化硬件：手脚，负责执行、搬运、操作。管的是实物流（货箱、托盘）

没有 WMS，自动化设备就是瞎子；没有自动化设备，WMS 只是一个”电子账本”。

1.2 几个关键概念

SKU（库存量单位）

SKU 是理解仓储的基石。简单说，它就是”一个独一无二的商品身份证”。

判断逻辑：只要品牌、口味、规格、包装中任何一个属性不同，就是一个全新的 SKU。

• 可口可乐 300ml 玻璃瓶原味 → SKU A
• 可口可乐 500ml 塑料瓶原味 → SKU B

SKU 数量直接决定了仓库的复杂度：几十个 SKU，普通货架就行；几万个 SKU，必须上自动化。

AGV vs AMR

这是两种不同的”搬运工”：

• AGV（自动导引车）：像有轨列车，需要铺设磁条或二维码，路径固定，遇到障碍物只会傻等
• AMR（自主移动机器人）：像自动驾驶汽车，用激光雷达实时建图，可以自主绕行

WMS vs WCS vs RCS

这三个系统各司其职：

• WMS：管”做什么”（订单、库存、策略）
• WCS：管”怎么做”（设备调度、路径优化）
• RCS：机器人的调度系统，把 WMS 的指令翻译成机器人能懂的语言

1.3 “自动”二字的真正含义

很多人以为”自动”就是有机器人在跑。实际上，真正的”自动”体现在三个层次：

1. 信息自动采集：RFID 读卡器在毫秒级自动读取货物信息，无需人工扫码
2. 任务自动分配：系统像滴滴调度中心，自动分配任务、规划路径
3. 设备自动协同：AGV 放下货物，传送带自动启动，分拣机自动转向，无需人工触发

第二部分：选择一条适合自己的路

2.1 开源方案 vs 商用方案

在开始搭建之前，我调研了市面上主流的方案：

开源方案对比：

• Odoo WMS（Python）：功能最强大，但学习曲线陡峭
• ERPNext WMS（Python）：体验最现代，但生态较小
• KopSoftWms（.NET）：轻量专注，MIT 协议可商用
• 易软通 open-wms（Java/Vue）：技术栈最新，国内社区活跃

我的选择：易软通 open-wms。

理由：Java/Vue 技术栈和我最熟悉，代码质量高，国内有社区支持，而且我已经跑通了。

2.2 一个重要的心态转变

刚开始我总想”一步到位”——直接上 AGV、立体库、全自动化。后来发现这是错的。

正确的思路是：先做软件 WMS，跑通入库 - 出库 - 库存三个核心流程，让数据准确率达到 99% 以上，再谈”自动”二字。

第三部分：动手搭建——从 0 到 1 跑通 WMS

3.1 环境准备

我用的是易软通 open-wms，技术栈：Java 17 + Spring Boot + Vue3 + MySQL 8 + Redis。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 克隆代码
git clone https://gitee.com/yiruantong/open-wms.git
git clone https://gitee.com/yiruantong/open-wms-ui.git

# 创建数据库
CREATE DATABASE wms DEFAULT CHARACTER SET utf8mb4;

# 导入初始 SQL
# 文件位置：open-wms/sql/

# 启动后端
cd open-wms
mvn clean install -DskipTests
cd ruoyi-admin
mvn spring-boot:run

# 启动前端
cd open-wms-ui
npm install
npm run dev

大约 2.5 小时，系统就跑起来了。访问 http://localhost:80，默认账号 admin/admin123。

3.2 初始化数据

系统跑起来后，需要录入真实数据：

1. 库位编码：按”区域 - 货架 - 层”规则，如 A-01-1
2. SKU 货品：SKU 编码、名称、分类、单位、安全库存
3. 绑定货品与库位：告诉系统”可口可乐 300ml 放在 A-01-1”

3.3 跑通核心流程

入库流程：创建入库单 → 选择货品和数量 → 选择目标库位 → 提交 → 库存自动增加

出库流程：创建出库单 → 关联订单号 → 选择货品 → 提交 → 库存自动扣减

盘点流程：新建盘点任务 → 录入实际数量 → 系统自动对比生成盘盈盘亏

3.4 接入扫码硬件

软件跑通后，加硬件提升效率：

• 扫码枪：京东 100-200 元，USB 即插即用
• PDA 手持终端：2000-3000 元，可在仓库里边走边扫

接入后，入库/出库只需扫一下条码，系统自动带出货品信息。

第四部分：理解”货到人”的运作逻辑

4.1 机器人搬什么？不是只有”搬整个货架”

这是最常见的误解。实际上有四种模式：

4.2 “位置变动”不会搞乱系统

刚接触时我困惑：货架被搬来搬去，系统怎么知道货在哪？

答案是：货架 ID 是固定的，系统不关心物理坐标，只关心”哪个货架装着哪个 SKU”。

数据库设计：

1
2
3
4
5
6
7
8
9
10
11
12
-- 货架表
CREATE TABLE mobile_racks (
    rack_id VARCHAR(64) PRIMARY KEY,  -- 货架唯一 ID
    current_zone VARCHAR(32)          -- 当前所在区域
);

-- 库存表
CREATE TABLE inventory (
    sku_code VARCHAR(64),
    quantity INT,
    rack_id VARCHAR(64)                -- 关键！货在哪个移动货架上
);

拣货时，WMS 查询”可乐在哪个货架” → 告诉 RCS”把这个货架搬过来” → RCS 查货架的实时坐标 → 派 AGV 去搬。

WMS 全程不关心物理坐标，那是 RCS 的事。

4.3 机器人搬过来后，然后呢？

机器人把货架搬到工作站后，人去拣货。这就是”货到人”模式。

工作站配置：

• 电脑屏幕：显示要拿什么、拿多少
• 电子标签：货架对应位置亮灯
• 扫码枪：扫描确认
• 按钮：确认完成，让 AGV 离开

效率对比：

第五部分：WMS 与机器人的对接

5.1 架构：不是 WMS 直接控制机器人

正确的架构：

1
WMS（业务层）→ RCS（调度层）→ AGV/AMR（执行层）

• WMS 发 HTTP 请求告诉 RCS”把 X 搬到 Y”
• RCS 负责路径规划、交通管制、任务分配
• 你的任务：让 WMS 和 RCS 能对接

5.2 对接代码实战

WMS 调用 RCS 下发任务示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@Service
public class RobotTaskService {
    public String sendMoveTask(String rackId, String targetStation) {
        Map<String, Object> request = new HashMap<>();
        request.put("taskId", UUID.randomUUID().toString());
        request.put("sourceId", rackId);
        request.put("targetId", targetStation);
        
        String url = rcsBaseUrl + "/api/v1/tasks/dispatch";
        ResponseEntity<Map> response = restTemplate.postForEntity(url, request, Map.class);
        
        return response.getBody().get("taskId");
    }
}

WMS 提供回调接口接收 RCS 状态：

1
2
3
4
5
6
7
8
9
10
11
12
13
@PostMapping("/api/rcs/callback/task/status")
public Result<Void> onTaskStatusChanged(@RequestBody TaskStatusCallback callback) {
    switch (callback.getStatus()) {
        case "COMPLETED":
            orderService.updateOrderStatus(callback.getOrderId(), "TO_PICK");
            workstationService.notifyGoodsArrived(callback.getTargetStation());
            break;
        case "FAILED":
            alertService.sendAlert("搬运任务失败", callback.getErrorMsg());
            break;
    }
    return Result.success();
}

5.3 机器人怎么知道”我在哪”？

不是靠死记硬背，而是”全局地图 + 实时定位”：

1. 事先建图：机器人先在仓库里走一遍，用激光雷达生成地图，标出”待处理区”坐标范围
2. 实时定位：运行时持续扫描环境，与地图匹配，实时计算自己坐标
3. 判断位置：把自己的坐标与地图上的”待处理区”范围比较

第六部分：部署与运维

6.1 生产环境部署架构

开发版是”所有东西跑在一台电脑上”，生产环境需要更健壮：

1
浏览器 → Nginx 反向代理 → WMS 实例 1/2 → MySQL 主库 + Redis 缓存

服务器配置建议：

• 云服务器：8GB/50GB 系统盘，5Mbps 带宽
• 约 50-200 元/月

systemd 服务配置：

1
2
3
[Service]
ExecStart=/usr/bin/java -jar -Xms2g -Xmx4g /opt/wms/ruoyi-admin.jar
Restart=on-failure

6.2 备份方案

1
2
3
4
5
# 每天自动备份
mysqldump wms_prod | gzip > backup_$(date +%Y%m%d).sql.gz

# 保留最近 30 天
find /backup -name "*.sql.gz" -mtime +30 -delete

6.3 常见坑位

第七部分：不同行业的方案选择

7.1 按 SKU 和出货单位分类

7.2 按预算推荐

第八部分：避坑指南与实战建议

8.1 程序员容易踩的坑

1. 一开始就想上机器人：WMS 没跑顺就买 AGV，最后机器人找不到货，因为库存数据都是错的
2. 低估数据的重要性：SKU 编码不规范、库位编码混乱，系统再好也用不起来
3. 忽视人的因素：技术再先进，员工抵触、不会用，项目也会失败
4. 追求大而全：从一个小模块开始（比如只管入库），跑通后再扩展

8.2 给产品定位的建议

基于易软通开源 WMS，可以这样定位产品线：

8.3 和客户沟通的三个关键问题

1. 有多少个 SKU？ → 判断复杂度
2. 出货单位是什么？ → 判断用哪种自动化方案
3. 预算大概多少？ → 判断方案范围

写在最后：一点心得

回顾整个学习过程，最大的感悟是：不要被”自动仓储”这个名词吓到。

作为程序员，我们天生擅长理解系统、写代码、解决问题。WMS 本质上就是一个业务系统，和电商后台、OA 系统没有本质区别。机器人对接就是 HTTP API 调用。自动化的核心是”信息流”的自动化，而不是设备的自动化。

如果你也想进入这个领域，我的建议是：

1. 从一个小项目开始：帮朋友的仓库上一个 WMS，哪怕只有几十个 SKU
2. 用开源方案快速验证：不要从零写，先跑通再定制
3. 分步走：先软件，后硬件；先人工，后自动
4. 持续学习：这个领域技术迭代很快，保持好奇心

你现在手里有一套能跑的开源 WMS，这已经超过 90% 只会讲概念的”仓储方案商”。拿它去一个真实的仓库，跑一周真实订单，你会发现自己已经入了门。

这篇文章记录了我从零到一搭建自动仓储管理系统的全过程。如果对某个环节有疑问，欢迎交流。

• Previous
  Qwen3.5-27B 深度解析：本地免费大模型的崛起之路
• Next
  如何做到全公司第一个发现技术动态？——构建你的技术信息雷达