# video-recommendation-system

**Repository Path**: sparkBoss/video-recommendation-system

## Basic Information

- **Project Name**: video-recommendation-system
- **Description**: 视频的
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-28
- **Last Updated**: 2025-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个性化视频推荐系统

这是一个基于Spring Boot和Vue.js开发的个性化视频推荐系统，适用于毕业设计。

## 系统功能

- 用户注册与登录
- 视频浏览与搜索
- 视频标签分类
- 视频点赞功能
- 基于用户喜好和地区的个性化推荐
- 管理员视频上传和管理

## 技术栈

- 后端：Spring Boot 3.x, Spring Security, Spring Data JPA
- 数据库：MySQL 8.0+
- 前端：Vue.js 3, Bootstrap 5
- 构建工具：Gradle 8.13 (使用Wrapper，无需本地安装)
- Java版本：JDK 21

## 环境准备

在开始前，请确保安装以下软件：

1. **Java Development Kit (JDK) 21**
   - 下载地址：<https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html>
   - 安装后，设置JAVA_HOME环境变量指向JDK安装目录
   - 将%JAVA_HOME%\bin添加到PATH环境变量
   - JDK 21的默认安装位置通常为：`C:\Program Files\Java\jdk-21`，可将`C:\Program Files\Java\jdk-21\bin`直接添加到PATH环境变量中

2. **Node.js**
   - 下载地址：<https://nodejs.org/en/download/>
   - 建议安装LTS长期支持版本
   - 安装时勾选"自动添加到PATH"选项

3. **MySQL 8.0+**
   - 详见下方安装步骤

## Windows环境下的启动步骤

### 1. 安装MySQL数据库

1. 下载MySQL安装包：<https://dev.mysql.com/downloads/installer/>
2. 按照向导完成安装，记住设置的用户名和密码
3. 创建数据库：

   ```sql
   CREATE DATABASE video_recommendation;
   ```

### 2. 配置后端

1. 打开`src/main/resources/application.properties`文件
2. 修改数据库连接信息：

   ```properties
   spring.datasource.url=jdbc:mysql://localhost:3306/video_recommendation?useSSL=false&serverTimezone=UTC
   spring.datasource.username=你的MySQL用户名
   spring.datasource.password=你的MySQL密码
   spring.jpa.hibernate.ddl-auto=update
   spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect
   ```

### 3. 启动后端服务

项目使用Gradle Wrapper，无需本地安装Gradle。

1. 首先确保您在项目根目录（含有gradlew.bat文件的video-recommendation-system目录）：

   ```bash
   # 如果您在上层目录，需要先进入项目目录
   cd video-recommendation-system
   ```

2. 执行以下命令启动后端：

   ```bash
   # Windows系统下启动后端（标准方式）
   gradlew.bat bootRun --info
   
   # 如果遇到内存不足错误，使用以下命令限制内存使用
   gradlew.bat -Dorg.gradle.jvmargs="-Xmx512m -XX:MaxMetaspaceSize=256m" bootRun --info
   
   # 或创建gradle.properties文件
   echo org.gradle.jvmargs=-Xmx512m -XX:MaxMetaspaceSize=256m > gradle.properties
   
   # 如需停止服务，可以按Ctrl+C或在任务管理器中结束Java进程
   ```

3. 等待服务启动完成
4. 后端服务默认地址：<http://localhost:8080>

### 4. 启动前端服务

1. 进入前端项目目录：

   ```bash
   cd frontend
   ```

2. 安装依赖（首次运行需要）：

   ```bash
   npm install
   ```

3. 启动前端开发服务器：

   ```bash
   # Windows系统下启动前端
   npm run serve
   
   # 如需停止服务，可以按Ctrl+C或在任务管理器中结束Node.js进程
   ```

4. 前端服务默认地址：<http://localhost:8082>

## 默认账户

系统初始化后会自动创建以下账户：

- 管理员账户：
  - 用户名: admin
  - 密码: admin

- 测试用户账户：
  - 用户名: user
  - 密码: user

## 项目目录结构

- `/video-recommendation-system` - 后端项目根目录
  - `/src/main/java/com/example/videorecommendation` - Java源代码
  - `/src/main/resources` - 配置、模板和静态资源
  - `/frontend` - Vue.js前端项目

## 常见问题

1. **数据库连接失败**：检查MySQL服务是否启动，连接参数是否正确
2. **后端服务启动失败**：检查端口8080是否被占用，可在application.properties修改端口
3. **前端服务启动失败**：检查Node.js版本是否兼容，推荐使用LTS版本
4. **Windows系统提示'gradlew'不是内部或外部命令**：请确保使用`gradlew.bat`命令
5. **Windows系统提示'npm'不是内部或外部命令**：请安装Node.js并将其添加到PATH环境变量中
6. **Gradle下载超时**：如遇到"Timeout waiting for exclusive access to file"错误：
   - 检查网络连接
   - 关闭所有命令行窗口，重新打开尝试
   - 删除`C:\Users\用户名\.gradle\wrapper\dists`目录下的对应gradle版本文件夹，重新运行
   - 手动下载gradle-8.13-bin.zip并放入对应目录
7. **Java内存不足错误**：如遇到"页面文件太小，无法完成操作"或"insufficient memory for the Java Runtime Environment"：
   - 增加Windows系统的虚拟内存（页面文件）大小：
     1. 右键点击"此电脑" → 属性 → 高级系统设置 → 高级 → 性能设置 → 高级 → 更改
     2. 取消勾选"自动管理所有驱动器的分页文件大小"
     3. 选择系统盘，选择"自定义大小"，初始大小和最大大小都设为物理内存的1.5到2倍（如8GB内存，设置为12000-16000 MB）
     4. 点击"设置"，然后重启电脑
   - 使用以下方法限制Gradle内存使用：

     ```
     # 方法1：命令行参数（临时）
     gradlew.bat -Dorg.gradle.jvmargs="-Xmx512m -XX:MaxMetaspaceSize=256m" bootRun
     
     # 方法2：创建gradle.properties文件（永久）
     # 在项目根目录创建gradle.properties文件，添加以下内容：
     # org.gradle.jvmargs=-Xmx512m -XX:MaxMetaspaceSize=256m
     ```

## 开发环境推荐

- IntelliJ IDEA或Visual Studio Code
- MySQL Workbench (数据库管理工具)
- Postman (API测试工具)

## 许可证

项目基于MIT许可证开源。