快速启动指南.md 3.6 KB
后台管理系统快速启动指南
🚀 三步启动
步骤1：启动后端服务
# 在 book 项目根目录执行
cd book
mvn spring-boot:run
等待看到：
Started BookApplication
Tomcat started on port(s): 8081
步骤2：启动前端服务
# 打开新的终端窗口，进入 book-admin 目录
cd book-admin
# 首次使用需要安装依赖
npm install
# 启动前端开发服务器（自动打开浏览器）
npm run dev
步骤3：登录系统
访问：http://localhost:8000/pages/login.html
默认管理员账号：
- 用户名：
admin - 密码：
admin123
📋 启动前检查
1. 检查数据库
确保MySQL服务已启动，并且数据库 books_db 已创建。
如果还没有创建管理员账号，执行：
# 在 book 项目根目录执行
mysql -u root -p books_db < src/main/resources/db/admin_schema.sql
2. 检查环境
- ✅ Java 17（已升级）
- ✅ Maven 3.x
- ✅ MySQL 5.7+ 或 MySQL 8.0+
- ✅ Node.js 和 npm
🔍 验证服务
后端服务验证
访问：http://localhost:8081/api/admin/login
如果能看到响应（即使是错误响应），说明后端服务已启动。
前端服务验证
访问：http://localhost:8000/pages/login.html
如果能看到登录页面，说明前端服务已启动。
📝 启动命令汇总
Windows PowerShell
# 终端1：启动后端服务
cd book
mvn spring-boot:run
# 终端2：启动前端服务
cd book-admin
npm install # 首次使用
npm run dev
Windows CMD
# 终端1：启动后端服务
cd book
mvn spring-boot:run
# 终端2：启动前端服务
cd book-admin
npm install # 首次使用
npm run dev
Mac/Linux
# 终端1：启动后端服务
cd book
mvn spring-boot:run
# 终端2：启动前端服务
cd book-admin
npm install # 首次使用
npm run dev
🆘 常见问题
问题1：后端服务无法启动
错误： 端口8081被占用
解决：
- 检查8081端口是否被占用
- 或者修改
application.properties中的端口号
问题2：前端服务无法启动
错误： npm: command not found
解决：
- 检查Node.js是否安装：
node -v - 检查npm是否安装：
npm -v - 如果未安装，请先安装Node.js
问题3：无法连接到后端服务
错误： "Failed to fetch"
解决：
- 检查后端服务是否启动
- 检查后端服务端口是否为8081
- 检查前端API地址配置（
utils/api.js）
问题4：登录失败
错误： "用户名或密码错误"
解决：
- 检查管理员账号是否创建
- 检查管理员账号角色是否为
admin - 检查密码是否正确（默认：admin123）
问题5：npm install 失败
错误： 网络错误
解决：
# 使用国内镜像源
npm config set registry https://registry.npmmirror.com
npm install
✅ 启动检查清单
- MySQL服务已启动
- 数据库
books_db已创建 - 管理员账号已创建（用户名：admin，角色：admin）
- 后端服务已启动（端口8081）
- 前端依赖已安装（npm install）
- 前端服务已启动（端口8000）
- 可以访问登录页面
- 可以正常登录
📚 相关文档
README.md- 完整功能说明启动指南.md- 详细启动步骤使用说明.md- 使用说明
🎯 快速访问
- 登录页面：
http://localhost:8000/pages/login.html - 书籍管理页面：
http://localhost:8000/pages/books.html（需要登录） - 后端API：
http://localhost:8081/api/admin/login