RFID仓储管理系统实战：从需求分析到前后端分离开发全流程

基于RFID技术的仓储管理系统实战：从需求分析到Vue+Python完整实现

之前在帮计算机专业的同学做毕业设计选题时，发现“仓储管理系统”是被提到最多的方向之一。但很多同学不知道从哪里入手，有的只做了简单的增删改查，没有体现“RFID”这个核心关键词的价值；还有的卡在前后端联调、RFID数据采集上。

这篇文章围绕“基于RFID技术的仓储管理系统”，从需求分析、技术选型、数据库设计、后端接口、前端页面到联调运行，整理成一套可以直接参考学习的完整教程。无论你是做毕业设计、课程设计，还是刚开始接触前后端分离项目，都可以按照本文的思路一步步落地。文中还会给出常见报错的排查方案，方便你对照处理。

1. 什么是RFID仓储管理系统

1.1 RFID技术的基本概念

RFID全称是Radio Frequency Identification，即射频识别技术。它利用无线电波在读写器和电子标签之间传输数据，实现远距离、非接触式的自动识别。日常生活中的门禁卡、校园卡、超市防盗标签，其实都用到了RFID技术。

RFID系统通常由三部分组成：

• 电子标签：附着在货物或托盘上，存储唯一的标识信息，例如EPC编码。
• 读写器：通过天线发射射频信号，读取或写入标签数据。
• 后台系统：接收读写器传来的标签数据，完成业务逻辑处理，例如出入库登记、库存更新。

相比传统的条码扫码，RFID最大的特点是批量读取和远距离识别。仓库员工不需要逐个扫描条码，只要推着货物经过读写器通道，就能一次性读取整批货物的标签信息。这正好适合出入库频繁、货物数量多的仓储场景。

1.2 仓储管理系统为什么要用RFID

传统仓储管理依赖手工记录和Excel表格，存在几个明显问题：

• 出入库登记慢，容易出现漏记、错记。
• 库存数量更新不及时，导致账实不符。
• 货物查找困难，盘点时需要人工逐一核对。
• 数据分散在不同表格中，难以形成完整的业务闭环。

引入RFID之后，每一件货物都有一个唯一标签，读写器自动采集数据，后台系统通过Python后端程序解析标签内容，再调用入库、出库、查询等接口，最终把库存状态同步到Vue前端页面。整个过程减少了人工操作环节，准确率和效率都能明显提升。

1.3 本项目的定位

本文实现的系统是一个演示级别的Web应用，核心目标是展示“RFID数据采集 + 仓储业务管理 + Web可视化”的完整链路。

项目采用前后端分离架构：

• 后端：Python + Flask + MySQL，处理业务逻辑和数据存储。
• 前端：Vue 3 + Element Plus + Axios，展示页面和交互操作。
• RFID模块：在真实项目中通过串口或USB连接RFID读写器；本文同时提供“串口读取”和“模拟生成”两种数据来源，方便没有硬件的同学调试。

技术栈属于计算机毕业设计中的主流组合，既能体现RFID硬件应用能力，又能展示Python后端和Vue前端的前后端分离开发能力。

2. 系统需求分析与功能模块设计

2.1 需求分析

在动手写代码之前，先明确系统到底要解决什么问题。以一个通用仓库场景为例，管理员需要完成以下工作：

• 新采购的货物到达仓库，需要登记入库。
• 货物被领取或销售出库，需要登记出库。
• 管理员随时查看当前库存情况。
• 管理员能查看每条出入库的记录，方便对账。
• 系统提供登录校验，保证数据不被随意修改。

结合RFID特点，业务流程可以这样设计：

1. 货物入库时，仓库人员为每件货物粘贴RFID标签。
2. 读写器扫描标签，把标签编码发送到后端。
3. 后端根据标签编码，查询或创建货物信息，再执行入库操作。
4. 货物出库时，读写器再次扫描，后端校验货物是否存在、库存是否充足，然后执行出库。
5. Vue前端实时展示库存数据和操作结果。

2.2 功能模块划分

根据上述流程，系统可以拆分为以下几个功能模块：

如果只是做毕设，不需要把每个模块都做得很重，但至少要让系统形成“入库—库存—出库—记录查询”的完整闭环。

2.3 数据结构设计

数据库建议设计以下几张核心表：

• 用户表：保存登录账号和密码。
• 货物表：保存商品名称、规格、单位、预警库存等信息。
• 标签表：保存RFID标签EPC编码，并关联货物ID。
• 库存表：保存货物当前总数量。
• 出入库记录表：保存每次入库或出库的操作类型、数量、时间、操作人。

下面给出SQL建表脚本，大家可以直接在MySQL中执行。

CREATE DATABASE IF NOT EXISTS rfid_warehouse DEFAULT CHARACTER SET utf8mb4; USE rfid_warehouse; CREATE TABLE `user` ( `id` INT NOT NULL AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL COMMENT '用户名', `password` VARCHAR(255) NOT NULL COMMENT '密码（建议存储哈希值）', `role` VARCHAR(20) DEFAULT 'admin' COMMENT '角色', PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; CREATE TABLE `goods` ( `id` INT NOT NULL AUTO_INCREMENT, `name` VARCHAR(100) NOT NULL COMMENT '货物名称', `specification` VARCHAR(100) DEFAULT NULL COMMENT '规格型号', `unit` VARCHAR(20) DEFAULT '件' COMMENT '单位', `warning_stock` INT DEFAULT 0 COMMENT '预警库存', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='货物表'; CREATE TABLE `rfid_tag` ( `id` INT NOT NULL AUTO_INCREMENT, `epc` VARCHAR(64) NOT NULL COMMENT '标签EPC编码', `goods_id` INT DEFAULT NULL COMMENT '关联货物ID', `status` TINYINT DEFAULT 1 COMMENT '标签状态 1-可用 0-禁用', `bind_time` DATETIME DEFAULT NULL COMMENT '绑定时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_epc` (`epc`), KEY `idx_goods_id` (`goods_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='RFID标签表'; CREATE TABLE `stock` ( `id` INT NOT NULL AUTO_INCREMENT, `goods_id` INT NOT NULL COMMENT '货物ID', `quantity` INT NOT NULL DEFAULT 0 COMMENT '库存数量', `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_goods_id` (`goods_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='库存表'; CREATE TABLE `stock_record` ( `id` INT NOT NULL AUTO_INCREMENT, `goods_id` INT NOT NULL COMMENT '货物ID', `type` VARCHAR(10) NOT NULL COMMENT 'in-入库 out-出库', `quantity` INT NOT NULL COMMENT '数量', `operator_id` INT DEFAULT NULL COMMENT '操作人ID', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '操作时间', PRIMARY KEY (`id`), KEY `idx_goods_id` (`goods_id`), KEY `idx_create_time` (`create_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='出入库记录表';

这里需要注意，密码字段建议使用哈希值存储，不要明文保存。实际项目中可以使用werkzeug库提供的密码哈希函数，这也是Flask生态中常见的做法。

3. 环境准备与项目初始化

3.1 版本环境说明

本文示例在以下环境中开发和测试：

• 操作系统：Windows 10 / 11 或 Ubuntu 20.04均可。
• Python版本：3.8及以上。
• Node.js版本：16.0及以上。
• 数据库：MySQL 5.7或8.0。
• 后端框架：Flask 2.x。
• 前端框架：Vue 3 + Element Plus。

如果你的本机环境版本略有不同，不用担心，核心代码使用的是通用API，不存在严重兼容性问题。如果Python版本过高，个别依赖可能还没有适配，建议使用3.8到3.10之间的稳定版本。

3.2 后端环境准备

为了方便管理Python依赖，建议先创建虚拟环境。

mkdir rfid-warehouse cd rfid-warehouse mkdir backend frontend python -m venv venv # Windows下激活 venv\Scripts\activate # Linux/Mac下激活 # source venv/bin/activate

激活虚拟环境之后，安装后端依赖。

pip install flask flask-cors flask-sqlalchemy pymysql

• flask：Web框架，提供路由、请求处理等能力。
• flask-cors：解决前后端分离开发时的跨域问题。
• flask-sqlalchemy：ORM框架，简化数据库操作。
• pymysql：Python连接MySQL的驱动库。

为了让你的项目具备真实的RFID数据读取能力，建议额外安装串口通信库。这里需要说明一下，RFID读写器的品牌有很多，不同厂家提供的SDK差别很大。本文以通用串口读取思路为例，实际使用时要参考你购买的读写器说明书。

pip install pyserial

如果你没有RFID硬件，可以跳过pyserial，直接使用模拟数据。本文后面会同时给出模拟实现方案。

3.3 前端环境准备

前端使用Vue 3。如果你还没有安装Vue CLI，可以先用npm初始化一个Vite项目。

cd frontend npm init vite@latest . -- --template vue npm install

接着安装Element Plus、Axios和Vue Router。

npm install element-plus axios vue-router@4

如果有同学想用Vue 2，也可以参考本文的页面逻辑，只是组件语法需要微调。当前主流的新项目建议直接使用Vue 3。

3.4 项目结构规划

整体项目结构如下：

rfid-warehouse/ ├── backend/ │ ├── app.py # 后端入口文件 │ ├── models.py # 数据库模型 │ ├── rfid_reader.py # RFID读写器处理模块 │ └── requirements.txt # 依赖清单 └── frontend/ ├── src/ │ ├── api/ │ │ ├── request.js # Axios请求封装 │ │ └── warehouse.js # 接口方法 │ ├── views/ │ │ ├── Login.vue # 登录页 │ │ ├── Dashboard.vue # 首页看板 │ │ ├── GoodsList.vue # 货物管理 │ │ ├── StockList.vue # 库存查询 │ │ ├── Inbound.vue # 入库操作 │ │ └── Outbound.vue # 出库操作 │ ├── router/index.js # 路由配置 │ └── App.vue └── package.json

这里把后端所有接口写在app.py入口文件中，适合单体项目快速开发，也方便毕设讲解。如果项目规模扩大，可以按蓝图拆分模块。

4. 后端核心代码实现

4.1 数据库连接和模型定义

在models.py中定义数据库模型。

# 文件路径：backend/models.py from flask_sqlalchemy import SQLAlchemy db = SQLAlchemy() class User(db.Model): __tablename__ = 'user' id = db.Column(db.Integer, primary_key=True, autoincrement=True) username = db.Column(db.String(50), unique=True, nullable=False) password = db.Column(db.String(255), nullable=False) role = db.Column(db.String(20), default='admin') class Goods(db.Model): __tablename__ = 'goods' id = db.Column(db.Integer, primary_key=True, autoincrement=True) name = db.Column(db.String(100), nullable=False) specification = db.Column(db.String(100)) unit = db.Column(db.String(20), default='件') warning_stock = db.Column(db.Integer, default=0) create_time = db.Column(db.DateTime, server_default=db.func.now()) class RfidTag(db.Model): __tablename__ = 'rfid_tag' id = db.Column(db.Integer, primary_key=True, autoincrement=True) epc = db.Column(db.String(64), unique=True, nullable=False) goods_id = db.Column(db.Integer, db.ForeignKey('goods.id')) status = db.Column(db.SmallInteger, default=1) bind_time = db.Column(db.DateTime) class Stock(db.Model): __tablename__ = 'stock' id = db.Column(db.Integer, primary_key=True, autoincrement=True) goods_id = db.Column(db.Integer, unique=True, nullable=False) quantity = db.Column(db.Integer, default=0) update_time = db.Column(db.DateTime, server_default=db.func.now(), onupdate=db.func.now()) class StockRecord(db.Model): __tablename__ = 'stock_record' id = db.Column(db.Integer, primary_key=True, autoincrement=True) goods_id = db.Column(db.Integer, nullable=False) type = db.Column(db.String(10), nullable=False) quantity = db.Column(db.Integer, nullable=False) operator_id = db.Column(db.Integer) create_time = db.Column(db.DateTime, server_default=db.func.now())

使用SQLAlchemy的好处是，不用手动拼接SQL语句，所有表操作都通过Python对象完成，能有效减少SQL注入风险。

4.2 Flask应用入口与路由

在app.py中完成Flask应用初始化、跨域配置、蓝图和路由注册。

# 文件路径：backend/app.py import json from flask import Flask, request, jsonify from flask_cors import CORS from werkzeug.security import generate_password_hash, check_password_hash from models import db, User, Goods, RfidTag, Stock, StockRecord app = Flask(__name__) CORS(app) # 数据库连接配置 app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:123456@localhost:3306/rfid_warehouse?charset=utf8mb4' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False db.init_app(app) # 初始化数据库和默认账号 @app.before_first_request def init_data(): db.create_all() if User.query.filter_by(username='admin').first() is None: admin = User(username='admin', password=generate_password_hash('admin123')) db.session.add(admin) db.session.commit() @app.route('/api/login', methods=['POST']) def login(): data = request.get_json() username = data.get('username') password = data.get('password') user = User.query.filter_by(username=username).first() if user is None or not check_password_hash(user.password, password): return jsonify({'code': 400, 'msg': '用户名或密码错误'}) return jsonify({'code': 200, 'msg': '登录成功', 'data': {'id': user.id, 'username': user.username, 'role': user.role}}) @app.route('/api/goods', methods=['GET']) def list_goods(): goods_list = Goods.query.all() data = [] for g in goods_list: stock = Stock.query.filter_by(goods_id=g.id).first() data.append({ 'id': g.id, 'name': g.name, 'specification': g.specification, 'unit': g.unit, 'warning_stock': g.warning_stock, 'stock': stock.quantity if stock else 0 }) return jsonify({'code': 200, 'data': data}) @app.route('/api/goods', methods=['POST']) def add_goods(): data = request.get_json() name = data.get('name') if not name: return jsonify({'code': 400, 'msg': '货物名称不能为空'}) goods = Goods( name=name, specification=data.get('specification', ''), unit=data.get('unit', '件'), warning_stock=data.get('warning_stock', 0) ) db.session.add(goods) db.session.commit() # 同时创建库存记录 stock = Stock(goods_id=goods.id, quantity=0) db.session.add(stock) db.session.commit() return jsonify({'code': 200, 'msg': '新增成功'}) @app.route('/api/rfid/bind', methods=['POST']) def bind_tag(): data = request.get_json() epc = data.get('epc') goods_id = data.get('goods_id') if not epc or not goods_id: return jsonify({'code': 400, 'msg': '标签编码和货物ID不能为空'}) tag = RfidTag.query.filter_by(epc=epc).first() if tag is None: tag = RfidTag(epc=epc, goods_id=goods_id, status=1, bind_time=db.func.now()) db.session.add(tag) else: tag.goods_id = goods_id tag.status = 1 db.session.commit() return jsonify({'code': 200, 'msg': '绑定成功'}) @app.route('/api/inbound', methods=['POST']) def inbound(): data = request.get_json() epc = data.get('epc') # RFID标签编码 quantity = data.get('quantity', 1) operator_id = data.get('operator_id', 1) tag = RfidTag.query.filter_by(epc=epc).first() if tag is None or tag.goods_id is None: return jsonify({'code': 400, 'msg': '标签不存在或未绑定货物'}) goods_id = tag.goods_id stock = Stock.query.filter_by(goods_id=goods_id).first() if stock is None: stock = Stock(goods_id=goods_id, quantity=0) db.session.add(stock) stock.quantity += quantity record = StockRecord(goods_id=goods_id, type='in', quantity=quantity, operator_id=operator_id) db.session.add(record) db.session.commit() return jsonify({'code': 200, 'msg': '入库成功'}) @app.route('/api/outbound', methods=['POST']) def outbound(): data = request.get_json() epc = data.get('epc') quantity = data.get('quantity', 1) operator_id = data.get('operator_id', 1) tag = RfidTag.query.filter_by(epc=epc).first() if tag is None or tag.goods_id is None: return jsonify({'code': 400, 'msg': '标签不存在或未绑定货物'}) goods_id = tag.goods_id stock = Stock.query.filter_by(goods_id=goods_id).first() if stock is None or stock.quantity < quantity: return jsonify({'code': 400, 'msg': '库存不足'}) stock.quantity -= quantity record = StockRecord(goods_id=goods_id, type='out', quantity=quantity, operator_id=operator_id) db.session.add(record) db.session.commit() return jsonify({'code': 200, 'msg': '出库成功'}) @app.route('/api/stock', methods=['GET']) def list_stock(): stocks = Stock.query.all() data = [] for s in stocks: goods = Goods.query.get(s.goods_id) if goods: data.append({ 'goods_id': goods.id, 'goods_name': goods.name, 'quantity': s.quantity, 'unit': goods.unit, 'warning_stock': goods.warning_stock, 'status': '正常' if s.quantity > goods.warning_stock else '预警' }) return jsonify({'code': 200, 'data': data}) @app.route('/api/records', methods=['GET']) def list_records(): records = StockRecord.query.order_by(StockRecord.create_time.desc()).all() data = [] for r in records: goods = Goods.query.get(r.goods_id) data.append({ 'id': r.id, 'goods_name': goods.name if goods else '未知货物', 'type': '入库' if r.type == 'in' else '出库', 'quantity': r.quantity, 'create_time': r.create_time.strftime('%Y-%m-%d %H:%M:%S') }) return jsonify({'code': 200, 'data': data}) if __name__ == '__main__': app.run(host='0.0.0.0', port=5000, debug=True)

需要注意，before_first_request在Flask 2.3及以上版本中已经移除。如果使用的是新版Flask，可以用with app.app_context():手动创建表。下面给出适配新老版本的写法：

if __name__ == '__main__': with app.app_context(): db.create_all() if User.query.filter_by(username='admin').first() is None: admin = User(username='admin', password=generate_password_hash('admin123')) db.session.add(admin) db.session.commit() app.run(host='0.0.0.0', port=5000, debug=True)

4.3 RFID数据读取模块

真实项目中，RFID读写器通过串口发送数据，Python使用pyserial库读取串口数据。由于不同厂商的协议不同，下面只给出一个通用读取框架：如果你有设备，请按厂商协议解析数据；如果没有设备，可以使用模拟数据生成器。

# 文件路径：backend/rfid_reader.py import time import random class RFIDReader: """RFID读写器封装类""" def __init__(self, port='COM3', baudrate=115200): self.port = port self.baudrate = baudrate self.serial = None def connect(self): """连接读写器。真实设备请根据厂商SDK调整。""" try: import serial self.serial = serial.Serial(self.port, self.baudrate, timeout=1) print('RFID Reader connected') return True except Exception as e: print(f'RFID Reader connection failed: {e}') return False def read_epc(self): """读取一个EPC编码""" if self.serial is None: # 模拟数据：E280 11 22 33 44 55 66 77 return 'E280' + ''.join(random.choices('0123456789ABCDEF', k=12)) # 真实设备读取逻辑，需要根据协议解析串口数据 data = self.serial.read(32) return data.hex().upper() def close(self): if self.serial: self.serial.close()

在出入库接口中，可以增加一个“从读写器读取当前标签”的辅助函数，让前端调用。例如：

@app.route('/api/rfid/scan', methods=['GET']) def scan_rfid(): reader = RFIDReader() if not reader.connect(): # 连接失败时仍返回模拟数据，方便演示 epc = 'E280' + ''.join(random.choices('0123456789ABCDEF', k=12)) return jsonify({'code': 200, 'data': {'epc': epc}}) epc = reader.read_epc() reader.close() return jsonify({'code': 200, 'data': {'epc': epc}})

这种设计的优点是：有硬件时可以真实读取，没有硬件时也不影响系统演示。

5. 前端核心页面实现

5.1 Axios请求封装

为了让接口调用更统一，先封装axios请求对象。在frontend/src/api/request.js中写入如下代码：

// 文件路径：frontend/src/api/request.js import axios from 'axios' import { ElMessage } from 'element-plus' const request = axios.create({ baseURL: 'http://localhost:5000/api', timeout: 10000 }) // 请求拦截器 request.interceptors.request.use(config => { const token = localStorage.getItem('token') if (token) { config.headers.Authorization = token } return config }) // 响应拦截器 request.interceptors.response.use( response => { const res = response.data if (res.code !== 200) { ElMessage.error(res.msg || '请求失败') return Promise.reject(new Error(res.msg || '请求失败')) } return res }, error => { ElMessage.error(error.message || '网络异常') return Promise.reject(error) } ) export default request

5.2 接口方法定义

在warehouse.js中集中管理接口方法。

// 文件路径：frontend/src/api/warehouse.js import request from './request' // 登录 export function login(data) { return request.post('/login', data) } // 货物列表 export function listGoods() { return request.get('/goods') } // 新增货物 export function addGoods(data) { return request.post('/goods', data) } // 绑定标签 export function bindTag(data) { return request.post('/rfid/bind', data) } // 扫描RFID标签 export function scanRfid() { return request.get('/rfid/scan') } // 入库 export function inbound(data) { return request.post('/inbound', data) } // 出库 export function outbound(data) { return request.post('/outbound', data) } // 库存查询 export function listStock() { return request.get('/stock') } // 出入库记录 export function listRecords() { return request.get('/records') }

5.3 入库页面

入库页面是整个系统的核心交互页面，它需要完成三个动作：扫描RFID标签、填写入库数量、提交入库请求。

<!-- 文件路径：frontend/src/views/Inbound.vue --> <template> <div class="page-container"> <el-card> <template #header> <span>入库操作</span> </template> <el-form :model="form" label-width="100px" style="max-width: 500px"> <el-form-item label="标签编码"> <el-input v-model="form.epc" placeholder="点击右侧按钮读取RFID标签" /> </el-form-item> <el-form-item label="数量"> <el-input-number v-model="form.quantity" :min="1" /> </el-form-item> <el-form-item> <el-button type="primary" @click="handleScan">读取标签</el-button> <el-button type="success" @click="handleInbound">确认入库</el-button> </el-form-item> </el-form> </el-card> <el-card style="margin-top: 20px"> <template #header> <span>最近入库记录</span> </template> <el-table :data="records" stripe> <el-table-column prop="goods_name" label="货物名称" /> <el-table-column prop="quantity" label="数量" /> <el-table-column prop="create_time" label="时间" /> </el-table> </el-card> </div> </template> <script setup> import { ref, onMounted } from 'vue' import { ElMessage } from 'element-plus' import { scanRfid, inbound, listRecords } from '../api/warehouse' const form = ref({ epc: '', quantity: 1 }) const records = ref([]) // 读取RFID标签 const handleScan = async () => { const res = await scanRfid() form.value.epc = res.data.epc ElMessage.success('标签读取成功') } // 提交入库 const handleInbound = async () => { if (!form.value.epc) { ElMessage.warning('请先读取标签') return } await inbound({ epc: form.value.epc, quantity: form.value.quantity, operator_id: 1 }) ElMessage.success('入库成功') loadRecords() } // 加载入库记录 const loadRecords = async () => { const res = await listRecords() records.value = res.data.filter(item => item.type === '入库').slice(0, 10) } onMounted(() => { loadRecords() }) </script>

出库页面与入库页面结构相同，差异在于调用的接口和过滤条件，这里不再重复贴出完整代码。你可以把上面的inbound替换成outbound，把记录过滤条件改成type === '出库'。

5.4 库存看板页面

库存看板用于展示当前所有货物的库存状态，并且用标签颜色区分正常和预警。

<!-- 文件路径：frontend/src/views/Dashboard.vue --> <template> <div class="page-container"> <el-row :gutter="20"> <el-col :span="8"> <el-card> <div class="stat-number">{{ totalGoods }}</div> <div class="stat-label">货物种类</div> </el-card> </el-col> <el-col :span="8"> <el-card> <div class="stat-number">{{ totalStock }}</div> <div class="stat-label">库存总量</div> </el-card> </el-col> <el-col :span="8"> <el-card> <div class="stat-number">{{ warningCount }}</div> <div class="stat-label">预警种类</div> </el-card> </el-col> </el-row> <el-card style="margin-top: 20px"> <template #header> <span>库存列表</span> </template> <el-table :data="stockList" stripe> <el-table-column prop="goods_name" label="货物名称" /> <el-table-column prop="quantity" label="库存数量" /> <el-table-column prop="unit" label="单位" /> <el-table-column prop="status" label="状态"> <template #default="{ row }"> <el-tag :type="row.status === '预警' ? 'danger' : 'success'"> {{ row.status }} </el-tag> </template> </el-table-column> </el-table> </el-card> </div> </template> <script setup> import { ref, computed, onMounted } from 'vue' import { listStock } from '../api/warehouse' const stockList = ref([]) const totalGoods = computed(() => stockList.value.length) const totalStock = computed(() => stockList.value.reduce((sum, item) => sum + item.quantity, 0)) const warningCount = computed(() => stockList.value.filter(item => item.status === '预警').length) onMounted(async () => { const res = await listStock() stockList.value = res.data }) </script>

6. 运行与联调验证

6.1 启动后端服务

在backend目录下，先确保虚拟环境已激活，然后运行：

python app.py

看到类似输出说明启动成功：

* Running on http://0.0.0.0:5000

此时后端接口已经可用，可以在浏览器中访问http://localhost:5000/api/stock查看返回的JSON数据。如果接口报错，请检查MySQL连接配置是否与本地环境一致。

6.2 启动前端项目

在frontend目录下运行：

npm run dev

看到 Vite 输出的本地端口后，打开浏览器访问即可。默认情况下Vite端口是5173，后端端口是5000。由于我们在后端配置了CORS，前端可以直接请求后端接口，不会出现跨域拦截。

6.3 操作演示流程

登录系统后，建议按照以下顺序操作：

1. 新增一种货物，例如“无线扫码枪”。
2. 手动输入一个RFID标签编码，把标签绑定到刚才新增的货物上。
3. 进入入库页面，点击“读取标签”按钮，模拟扫描标签。
4. 填写入库数量，点击“确认入库”。
5. 进入库存页面，确认库存数量已经增加。
6. 执行出库操作，再回到库存页面，确认库存扣减。

如果所有步骤都成功，说明整个数据链路已经打通：RFID标签数据 → 后端接口 → MySQL持久化 → Vue前端展示。

6.4 预期效果说明

完成上述操作后，你应该能在页面上看到：

• 货物列表中显示所有货物基础信息和当前库存。
• 库存看板中正确统计货物种类数量、总库存量和预警数量。
• 出入库记录页面按时间倒序展示每一次操作。
• 库存不足时，对应货物显示为预警状态。

7. 常见问题与排查思路

在实际开发和运行过程中，同学们经常会遇到下面这些问题。

补充几个容易忽略的细节：

• Flask的debug模式在生产环境要关闭，毕设答辩时保持debug=True没问题，但项目部署时建议关闭。
• 登录接口目前只验证账号密码，没有生成JWT或Session。如果需要在多个页面之间保持登录状态，可以引入flask-jwt-extended。
• 数据库中的密码使用哈希存储，这是最基本的底线，不要为了图省事存明文密码。
• RFID读写器如果一直连不上，先确认USB转串口驱动是否安装，再确认读写器的波特率是否匹配。

8. 最佳实践与工程建议

8.1 后端设计建议

• 接口统一返回{ code, msg, data }结构，前端可以用拦截器统一处理错误。
• 数据库操作使用事务包裹，特别是出入库接口，要保证“库存更新 + 记录插入”要么同时成功，要么同时失败。
• 可以在事务内部加上行锁，避免并发操作导致库存数据错误。例如：

from sqlalchemy import text @app.route('/api/inbound', methods=['POST']) def inbound(): # 其他逻辑... db.session.execute(text('SELECT * FROM stock WHERE goods_id = :gid FOR UPDATE'), {'gid': goods_id}) # 更新库存...

8.2 前端设计建议

• 页面组件尽量复用，入库和出库页面可以抽取公共的StockOperation组件。
• Axios请求统一封装，不要在每一个组件里重复写axios.post。
• 路由懒加载写法：component: () => import('../views/Inbound.vue')，避免首屏加载过慢。

8.3 RFID硬件接入的注意事项

• 读写器的工作频段不同，常见的有低频125kHz、高频13.56MHz、超高频860-960MHz。仓储场景一般使用超高频RFID，读取距离远、读取速度快。
• 标签绑定到货物后，应在数据库中持久化关联关系，避免每次重复绑定。
• 实际部署时，多个读写器同时工作可能存在信号干扰，需要在仓库出入口设计合理的读写器安装位置。
• RFID标签的粘贴位置如果靠近金属物品，可能会影响读取效果，需要使用抗金属标签。

8.4 安全性边界

作为毕业设计或演示项目，安全性可以做到基本够用，但有几个点不能忽略：

• 密码必须哈希存储。
• 出入库接口的operator_id应该来自登录状态，而不是前端传参。
• 数据库连接串不要把密码写死在代码里，可以使用环境变量读取。
• 生产环境禁止开启debug模式。

9. 总结与下一步学习路线

本文围绕“基于RFID技术的仓储管理系统”完整演示了从需求分析、数据库设计、Python后端接口到Vue前端页面的开发全过程。通过这个项目，你可以掌握以下知识点：

• RFID技术的基本组成和在仓储场景中的应用方式。
• 使用Flask + SQLAlchemy开发RESTful接口。
• 使用Vue 3 + Element Plus构建管理系统页面。
• 前后端分离项目的联调思路。
• 出入库业务中库存扣减与记录写入的事务一致性要求。

如果你正在做计算机毕业设计，这个项目已经具备完整的业务闭环，可以在此基础上继续扩展财务管理模块、报表统计模块、供应商管理模块等，让系统功能更丰富。

如果你希望深入学习，下一步可以关注以下方向：

• 使用JWT实现更完整的登录认证机制。
• 引入Redis缓存热点数据，提高接口响应速度。
• 学习Vue的Pinia状态管理，优化组件间通信。
• 研究RabbitMQ或Kafka，实现RFID事件消息的异步处理。
• 部署到Linux服务器，使用Nginx反向代理前端页面和后端接口。

开发这类管理系统，重要的不是堆砌多少技术栈，而是把“数据采集—业务处理—前端展示”这条链路走通。只要能把这个闭环理解透彻，换任何业务场景都能快速上手。遇到报错时，按数据库连接、接口日志、前端控制台三个方向排查，大多数问题都能找到线索。希望这篇文章对你的学习和毕设有所帮助。