MES 制造执行系统启动指南

系统架构

后端: Spring Boot + MySQL + MyBatis (端口: 8088)
前端: Vue 3 + Element Plus + ECharts (端口: 3000)
数据库: MySQL 8.0 (端口: 3306)

前置条件

必需软件

Java JDK 17+
- 验证: java -version
- 下载: https://adoptium.net/
Node.js 16+
- 验证: node --version
- 下载: https://nodejs.org/
MySQL 8.0
- 验证: mysql --version
- 数据库名: mes_sorter
- 用户: root
- 密码: Minato@114514

项目结构

WorkBench_Remake/
├── Back/
│   └── mes-sorter/           # Spring Boot后端
├── Front/
│   └── mes-frontend/         # Vue.js前端
└── start.bat                # 一键启动脚本

快速启动

一键启动

start.bat

手动启动（推荐用于调试）

后端启动

cd Back\mes-sorter
mvn spring-boot:run

前端启动

cd Front\mes-frontend
npm install  # 首次运行
npm run dev

访问地址

前端界面: http://localhost:3000
后端API: http://localhost:8088
API文档: http://localhost:8088/swagger-ui.html

故障排除

1. 编译错误

检查Java和Maven环境，确保依赖完整

2. 数据库连接错误

检查配置: Back\mes-sorter\src\main\resources\application.properties

spring.datasource.url=jdbc:mysql://localhost:3306/mes_sorter
spring.datasource.username=root
spring.datasource.password=Minato@114514

3. 端口占用

后端端口8088被占用: 修改 application.properties 中的 server.port
前端端口3000被占用: 修改 vite.config.js 中的 server.port

4. 前端代理错误

检查 Front\mes-frontend\vite.config.js:

proxy: {
  '/ep': {
    target: 'http://localhost:8088',
    changeOrigin: true
  }
}

5. MyBatis映射错误

确保存在以下文件：

Back\mes-sorter\src\main\resources\mapper\PieceMapper.xml
Back\mes-sorter\src\main\resources\mapper\DispatchMapper.xml

6. Maven依赖问题

cd Back\mes-sorter
mvn clean install

7. NPM依赖问题

cd Front\mes-frontend
npm install --force

API端点测试

仪表盘数据

curl http://localhost:8088/ep/mes/dashboard/stats

工位列表

curl http://localhost:8088/ep/mes/workstations/list

生产计划

curl http://localhost:8088/ep/mes/plan/items?pplansheet=20250618

开发调试

后端日志

日志级别: DEBUG
查看控制台输出
检查 logs/ 目录

前端调试

浏览器F12开发者工具
网络面板查看API请求
Console查看错误信息

数据库调试

-- 查看数据库状态
USE mes_sorter;
SHOW TABLES;

-- 检查关键表
SELECT COUNT(*) FROM piece;
SELECT COUNT(*) FROM workstation;
SELECT COUNT(*) FROM dispatch;

常见问题

Q: 前端页面空白

A: 检查浏览器控制台错误，通常是API调用失败

Q: 后端启动失败

A: 检查数据库连接，确保MySQL服务运行

Q: API返回500错误

A: 检查后端控制台日志，通常是数据库操作错误

Q: 跨域问题

A: 前端已配置代理，确保代理目标端口正确

系统功能验证

启动成功后，验证以下功能：

✅ 仪表盘统计数据加载
✅ 工位列表显示
✅ 生产计划查询
✅ 工件管理操作
✅ 设备状态监控
✅ 工人管理功能

联系支持

如果遇到问题，请提供：

错误截图
控制台日志
系统环境信息

启动指南.md 3.5 KB 永久連結 文件歷史 原始文件