Skip to content

MANUAL_START.md

Latest commit

 

History

History
256 lines (174 loc) · 5.2 KB

MANUAL_START.md

File metadata and controls

256 lines (174 loc) · 5.2 KB

WMS系统手动启动指南

🔴 当前问题

浏览器访问 http://localhost:3000 显示"无法访问此页面",这是因为前后端服务都还没有成功启动。

✅ 解决方案 - 手动启动

由于自动启动脚本在后台运行时无法交互,您需要手动在命令行窗口中启动服务。

📝 步骤1: 初始化数据库

打开第一个命令行窗口

  1. 按 Win + R
  2. 输入 cmd 回车
  3. 执行:
D:\WMS\init_db_now.bat

等待看到: "数据库初始化完成!"

如果看到错误,可能是PostgreSQL密码不对。请确认PostgreSQL密码是 123456

📝 步骤2: 启动后端服务

打开第二个命令行窗口

  1. 按 Win + R
  2. 输入 cmd 回车
  3. 执行:
cd /d D:\WMS\services\wms-basic-service
mvn spring-boot:run -Dspring-boot.run.profiles=prod

等待看到(约1-2分钟):

Started WmsBasicServiceApplication in XX.XXX seconds

注意: 不要关闭这个窗口,让后端一直运行

验证后端启动成功

打开浏览器,访问:

http://localhost:8080/api/v1/actuator/health

应该看到:

{"status":"UP"}

📝 步骤3: 启动前端服务

打开第三个命令行窗口

  1. 按 Win + R
  2. 输入 cmd 回车
  3. 执行:
cd /d D:\WMS\services\wms-frontend
npm start

等待看到(约30秒-1分钟):

webpack compiled successfully

浏览器应该会自动打开 http://localhost:3000

注意: 不要关闭这个窗口,让前端一直运行

📝 步骤4: 登录系统

浏览器打开 http://localhost:3000

  • 用户名: admin
  • 密码: admin123

🔧 常见问题排查

问题1: 后端启动失败 - Maven not found

错误提示: 'mvn' 不是内部或外部命令

解决方案:

  1. 检查Maven是否安装: 打开新命令行输入 mvn -version
  2. 如果未安装,下载Maven并配置环境变量
  3. 或者使用IDEA/Eclipse等IDE直接运行 WmsBasicServiceApplication.java

问题2: 后端启动失败 - 端口被占用

错误提示: Port 8080 was already in use

解决方案:

netstat -ano | findstr :8080
taskkill /F /PID <进程ID>

问题3: 后端启动失败 - 数据库连接错误

错误提示: Connection refused 或 Access denied

解决方案:

  1. 确认PostgreSQL正在运行:
netstat -ano | findstr :5432

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

    • 打开"服务"管理器 (services.msc)
    • 找到 postgresql-x64-17
    • 右键 > 启动

  2. 确认密码正确:

    • 打开 D:\WMS\services\wms-basic-service\src\main\resources\application-prod.yml
    • 检查 password 是否是您的PostgreSQL密码

问题4: 前端启动失败 - npm not found

错误提示: 'npm' 不是内部或外部命令

解决方案:

  1. 检查Node.js是否安装: node -v
  2. 如果未安装,下载Node.js: https://nodejs.org/
  3. 安装后重启命令行窗口

问题5: 前端启动失败 - 依赖未安装

错误提示: Cannot find module 'react'

解决方案:

cd /d D:\WMS\services\wms-frontend
npm install
npm start

问题6: 前端启动失败 - 端口被占用

错误提示: Something is already running on port 3000

解决方案:

netstat -ano | findstr :3000
taskkill /F /PID <进程ID>

🎯 启动成功的标志

后端成功启动

✅ 命令行显示: Started WmsBasicServiceApplication ✅ 访问 http://localhost:8080/api/v1/actuator/health 返回 {"status":"UP"}

前端成功启动

✅ 命令行显示: webpack compiled successfully ✅ 浏览器自动打开 http://localhost:3000 ✅ 看到登录页面

系统正常运行

✅ 能够成功登录 ✅ 首页显示数据 ✅ 各功能模块可以访问

📊 启动状态检查

执行这个脚本快速检查:

D:\WMS\check_services.bat

或手动检查:

REM 检查后端
curl http://localhost:8080/api/v1/actuator/health

REM 检查端口
netstat -ano | findstr ":8080"
netstat -ano | findstr ":3000"
netstat -ano | findstr ":5432"

🔍 日志查看

后端日志

D:\WMS\services\wms-basic-service\logs\wms-basic-service.log

前端日志

  • 查看启动前端的命令行窗口
  • 或浏览器开发者工具 Console (F12)

💡 重要提示

  1. 三个窗口都要保持运行:

    • 数据库初始化可以关闭
    • 后端窗口必须保持开启
    • 前端窗口必须保持开启

  2. 启动顺序很重要:

    • 先数据库 → 再后端 → 最后前端

  3. 等待时间:

    • 后端第一次启动约需1-2分钟
    • 前端第一次启动约需30秒-1分钟

  4. 如果修改了代码:

    • 后端: Ctrl+C 停止,重新运行 mvn spring-boot:run
    • 前端: Ctrl+C 停止,重新运行 npm start

📞 需要帮助?

查看完整文档

  • D:\WMS\START_GUIDE.md - 详细启动指南
  • D:\WMS\FIX_SUMMARY.md - 问题修复记录
  • D:\WMS\FINAL_INSTRUCTIONS.md - 快速开始指南

检查配置

  • 后端配置: D:\WMS\services\wms-basic-service\src\main\resources\application-prod.yml
  • 前端配置: D:\WMS\services\wms-frontend\.env

创建时间: 2025-10-09 适用场景: 自动启动脚本无法工作时的手动启动方案