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

后台管理系统启动指南

📋 启动前准备

1. 检查环境

• ✅ Java 8 或以上版本
• ✅ Maven 3.x
• ✅ MySQL 5.7 或以上版本
• ✅ Node.js 和 npm（用于启动前端服务器）
• ✅ 浏览器（Chrome、Firefox、Edge等）

2. 检查数据库

• ✅ MySQL 服务已启动
• ✅ 数据库 books_db 已创建
• ✅ 数据库用户有权限访问

🚀 启动步骤

步骤1：初始化数据库

1.1 执行数据库脚本

# 在book项目根目录执行
mysql -u root -p books_db < src/main/resources/db/admin_schema.sql

1.2 验证管理员账号

-- 连接到MySQL
mysql -u root -p books_db

-- 查看管理员账号
SELECT id, username, nickname, role, status FROM users WHERE username = 'admin';

期望结果：

• 应该有一条记录
• username = 'admin'
• role = 'admin'
• status = 1

步骤2：启动后端服务

2.1 使用Maven启动（推荐）

# 在book项目根目录执行
mvn spring-boot:run

2.2 使用IDE启动

1. 打开IDE（如IntelliJ IDEA、Eclipse等）
2. 导入项目（Maven项目）
3. 找到 BookApplication.java 文件
4. 右键点击 → Run 'BookApplication'
5. 等待服务启动完成

2.3 验证后端服务

查看启动日志：

• 应该看到 Started BookApplication 日志
• 应该看到 Tomcat started on port(s): 8081 日志

测试服务：

• 打开浏览器，访问：http://localhost:8081/api/admin/login
• 如果能看到响应（即使是错误响应），说明服务已启动

步骤3：启动前端开发服务器

3.1 安装依赖（首次使用）

# 进入book-admin目录
cd book-admin

# 安装依赖
npm install

3.2 启动开发服务器

# 使用npm启动（推荐）
npm run dev

# 或者使用
npm start

功能：

• 启动本地服务器（端口8000）
• 自动打开浏览器
• 访问登录页面

3.3 验证前端服务

访问地址：

• 登录页面：http://localhost:8000/pages/login.html
• 如果页面正常显示，说明前端服务已启动

步骤4：登录系统

4.1 使用默认管理员账号登录

• 用户名： admin
• 密码： admin123

4.2 登录成功

登录成功后，会自动跳转到书籍管理页面（books.html）

🔍 问题排查

问题1：后端服务无法启动

错误信息： 端口被占用、数据库连接失败等

解决方法：

1. 检查端口8081是否被占用
2. 检查数据库配置（application.properties）
3. 检查MySQL服务是否启动
4. 检查数据库 books_db 是否存在

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

错误信息： "Failed to fetch"、"无法连接到后端服务"

解决方法：

1. 检查后端服务是否启动
2. 检查后端服务端口是否为8081
3. 检查前端API地址配置（utils/api.js）
4. 使用浏览器访问 http://localhost:8081/api/admin/login 测试

问题3：登录失败

错误信息： "用户名或密码错误"、"您不是管理员"

解决方法：

1. 检查管理员账号是否存在
2. 检查管理员账号角色是否为 admin
3. 检查管理员账号状态是否为 1（启用）
4. 检查密码是否正确（默认密码：admin123）

问题4：npm install 失败

错误信息： 网络错误、权限错误等

解决方法：

1. 检查网络连接

2. 使用国内镜像源：

   npm config set registry https://registry.npmmirror.com
   npm install
   

3. 清除缓存：

   npm cache clean --force
   npm install
   

问题5：端口被占用

错误信息： Port 8000 is already in use

解决方法：

1. 修改端口：编辑 package.json，修改端口号
2. 或者关闭占用端口的程序

📝 快速启动命令

Windows

# 终端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  # 启动开发服务器

✅ 启动检查清单

• MySQL服务已启动
• 数据库 books_db 已创建
• 已执行 admin_schema.sql 脚本
• 管理员账号已创建（用户名：admin，角色：admin）
• 后端服务已启动（端口8081）
• 后端服务启动日志正常
• 前端依赖已安装（npm install）
• 前端服务器已启动（端口8000）
• 可以访问登录页面
• 可以正常登录

🎯 启动后的操作

1. 测试登录

• 使用管理员账号登录
• 验证登录成功

2. 测试功能

• 查看书籍列表
• 添加书籍
• 编辑书籍
• 删除书籍
• 上架/下架书籍

3. 查看日志

• 后端服务日志
• 浏览器控制台日志
• 网络请求日志

💡 提示

1. 后端服务必须启动：前端无法独立运行，必须依赖后端服务
2. 使用npm启动：推荐使用 npm run dev 启动前端服务器
3. 检查端口：确保8081和8000端口未被占用
4. 查看日志：启动时查看日志，及时发现错误
5. 测试连接：使用浏览器测试后端服务连接状态

🆘 需要帮助？

如果遇到问题，请：

1. 查看错误日志
2. 查看浏览器控制台
3. 检查后端服务是否启动
4. 检查数据库连接是否正常