Back_end_Management_System/book-admin/快速启动指南.md

后台管理系统快速启动指南

🚀 三步启动

步骤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被占用

解决：

1. 检查8081端口是否被占用
2. 或者修改 application.properties 中的端口号

问题2：前端服务无法启动

错误： npm: command not found

解决：

1. 检查Node.js是否安装：node -v
2. 检查npm是否安装：npm -v
3. 如果未安装，请先安装Node.js

问题3：无法连接到后端服务

错误： "Failed to fetch"

解决：

1. 检查后端服务是否启动
2. 检查后端服务端口是否为8081
3. 检查前端API地址配置（utils/api.js）

问题4：登录失败

错误： "用户名或密码错误"

解决：

1. 检查管理员账号是否创建
2. 检查管理员账号角色是否为 admin
3. 检查密码是否正确（默认：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