Skip to content

START_GUIDE.md

Latest commit

 

History

History
194 lines (152 loc) · 4.46 KB

START_GUIDE.md

File metadata and controls

194 lines (152 loc) · 4.46 KB

WMS系统启动指南

已修复的问题

1. 前后端API路径不匹配 ✅

  • 问题: 前端配置 /api 但后端是 /api/v1
  • 修复: 已修改 services/wms-frontend/.env 文件 
    REACT_APP_API_BASE_URL=http://localhost:8080/api/v1

2. 后端使用H2内存数据库 ✅

  • 问题: 后端默认使用H2,每次重启数据丢失
  • 修复:
    • 修改 application.yml 激活profile为 prod
    • 创建 application-prod.yml 配置PostgreSQL

3. 数据库未初始化 ✅

  • 问题: 没有数据库和初始数据
  • 修复: 创建了数据库初始化脚本

启动步骤

步骤1: 初始化PostgreSQL数据库

方法A: 使用提供的脚本(推荐)

D:\WMS\setup_db.bat

方法B: 手动执行

# 设置密码环境变量
set PGPASSWORD=123456

# 执行SQL脚本
"D:\Program Files\PostgreSQL\17\bin\psql.exe" -U postgres -f D:\WMS\init_db_direct.sql

方法C: 使用完整的SQL脚本

如果需要完整的表结构,按顺序执行:

cd D:\WMS\database\schema
psql -U postgres -d wms_db -f 01_basic_data.sql
psql -U postgres -d wms_db -f 02_inventory.sql
psql -U postgres -d wms_db -f 03_inbound.sql
psql -U postgres -d wms_db -f 04_outbound.sql
# ... 其他SQL文件

步骤2: 编译后端项目

cd D:\WMS\services\wms-basic-service
mvn clean package -DskipTests

步骤3: 启动后端服务

cd D:\WMS\services\wms-basic-service
mvn spring-boot:run

或者直接运行打包后的jar:

java -jar target/wms-basic-service-1.0.0.jar

验证后端启动成功:

步骤4: 启动前端服务

cd D:\WMS\services\wms-frontend
npm start

访问系统:

配置信息

数据库配置

数据库: wms_db
主机: localhost
端口: 5432
用户: postgres
密码: 123456

后端配置

端口: 8080
Context-Path: /api/v1
Profile: prod

前端配置

端口: 3000
API地址: http://localhost:8080/api/v1

常见问题

Q1: 后端启动失败,提示数据库连接错误?

A: 检查PostgreSQL服务是否启动

tasklist | findstr postgres

如果没有运行,启动PostgreSQL服务

Q2: 前端登录后显示"服务器内部错误"?

A: 这通常是因为:

  1. 后端未启动或端口不对
  2. 数据库未初始化
  3. API路径配置错误

解决方案:

  1. 确认后端已启动: http://localhost:8080/api/v1/actuator/health
  2. 检查浏览器控制台的网络请求
  3. 查看后端日志: D:\WMS\services\wms-basic-service\logs\wms-basic-service.log

Q3: 数据库初始化失败?

A:

  1. 确认PostgreSQL密码是 123456
  2. 如果不是,修改脚本中的 set PGPASSWORD=你的密码
  3. 或者修改 application-prod.yml 中的 DB_PASSWORD

Q4: 后端编译失败?

A:

# 清理并重新编译
mvn clean install -DskipTests

# 如果还是失败,删除本地仓库缓存
rmdir /s /q %USERPROFILE%\.m2\repository
mvn clean install -DskipTests

验证系统功能

1. 登录测试

2. API测试

使用Postman或curl测试API:

# 登录
curl -X POST http://localhost:8080/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d "{\"username\":\"admin\",\"password\":\"admin123\"}"

# 查询仓库列表(需要先登录获取token)
curl -X GET "http://localhost:8080/api/v1/warehouse/page?current=1&size=10" \
  -H "Authorization: Bearer <your_token>"

3. 功能模块测试

登录后依次测试:

  • ✅ 基础数据 > 仓库管理
  • ✅ 基础数据 > 产品管理
  • ✅ 基础数据 > 客户管理
  • ✅ 库存管理 > 库存查询
  • ✅ 入库管理 > 入库单管理
  • ✅ 出库管理 > 出库单管理

下一步工作

  1. 清理Mock数据: 检查并删除前端中的mock数据和演示数据
  2. 完善业务逻辑: 确保所有CRUD操作正常
  3. 错误处理: 完善全局异常处理
  4. 权限控制: 实现RBAC权限管理
  5. 性能优化: 添加缓存和索引优化

技术支持

如遇到问题,请查看日志:

  • 后端日志: D:\WMS\services\wms-basic-service\logs\wms-basic-service.log
  • 前端控制台: 浏览器开发者工具 Console 和 Network 标签

文档更新时间: 2025-10-09 版本: v1.1