亲测免费！开源音乐网站项目10大常见问题解决方案

GitHub 加速计划 / mu / music-website 是一个基于 Vue + SpringBoot + MyBatis 开发的开源音乐网站项目，为音乐爱好者和开发者提供了完整的音乐播放、管理解决方案。本文整理了该项目使用过程中最常见的10个问题及详细解决方法，帮助新手快速避坑，顺利搭建属于自己的音乐网站。

🎧 项目简介

该开源音乐网站项目采用前后端分离架构，包含三个主要模块：

• music-client：基于 Vue 的用户前端界面
• music-manage：后台管理系统
• music-server：SpringBoot 后端服务

图：开源音乐网站项目启动日志界面，显示 Spring Boot 服务启动过程

🔧 环境配置问题

1. 项目启动失败：端口被占用

问题表现：启动后端服务时提示 "Address already in use"

解决方案：

1. 打开 music-server/src/main/resources/application.properties 文件
2. 修改服务器端口配置：server.port=8081（将8081替换为未占用端口）
3. 同时需要同步修改前端请求配置：music-client/src/api/request.ts 中的 baseURL 地址

2. 数据库连接失败

问题表现：启动时报错 "Could not get JDBC Connection"

解决方案：

1. 导入项目根目录下的 SQL 文件：music-server/sql/tp_music.sql
2. 修改数据库配置文件：music-server/src/main/resources/application.properties
3. 确保配置中的数据库地址、用户名和密码与本地环境一致

🚀 部署相关问题

3. Docker 部署容器启动失败

问题表现：执行 docker-compose up 后容器无法正常启动

解决方案：

1. 检查 music-server/docker-server/docker-compose.yml 文件配置
2. 确保本地 Docker 服务已启动
3. 尝试删除旧容器后重新构建：docker-compose down && docker-compose up --build

图：开源音乐网站项目Logo，融合音乐符号与唱片元素

4. 前端页面无法访问后端接口

问题表现：前端页面加载正常，但无法获取数据，控制台报403或500错误

解决方案：

1. 检查跨域配置：music-server/src/main/java/com/example/yin/config/CorsInterceptor.java
2. 确认后端服务已启动且端口正确
3. 检查前端请求封装：music-client/src/api/request.ts 中的拦截器配置

🎵 功能使用问题

5. 音乐上传功能无法使用

问题表现：后台管理系统中上传音乐文件失败

解决方案：

1. 检查 MinIO 配置：music-server/src/main/java/com/example/yin/config/MinioConfig.java
2. 确保 MinIO 服务已正确启动
3. 检查文件大小限制配置：music-server/src/main/java/com/example/yin/config/WebPicConfig.java

6. 播放列表无法加载

问题表现：前端页面显示"加载失败"或播放列表为空

解决方案：

1. 检查歌曲列表接口：music-server/src/main/java/com/example/yin/controller/SongListController.java
2. 确认数据库中存在歌曲数据
3. 检查前端组件：music-client/src/components/SongList.vue 的数据获取逻辑

图：音乐网站项目相关图片，展示高品质音乐体验

💻 开发相关问题

7. 前端开发环境运行报错

问题表现：执行 npm run serve 时报错 "Cannot find module"

解决方案：

1. 进入对应前端目录（music-client 或 music-manage）
2. 执行 npm install 安装依赖
3. 若仍有问题，删除 node_modules 目录和 package-lock.json 文件后重新安装

8. 后端接口修改不生效

问题表现：修改后端代码后重启服务，接口行为未改变

解决方案：

1. 确认代码已保存并重新编译
2. 检查是否使用了热部署：music-server/pom.xml 中的 devtools 配置
3. 尝试执行 mvn clean package 后重新启动服务

🔐 权限相关问题

9. 管理员登录失败

问题表现：后台管理系统登录提示"用户名或密码错误"

解决方案：

1. 检查默认管理员账号密码（通常在数据库初始化脚本中）
2. 检查登录接口实现：music-server/src/main/java/com/example/yin/controller/AdminController.java
3. 确认密码加密方式是否正确：music-server/src/main/java/com/example/yin/service/impl/AdminServiceImpl.java

10. 用户注册功能无法使用

问题表现：前端注册页面提交后无响应或提示错误

解决方案：

1. 检查注册接口：music-server/src/main/java/com/example/yin/controller/ConsumerController.java
2. 检查前端注册组件：music-client/src/views/SignUp.vue
3. 确认数据验证逻辑：music-client/src/enums/validate.ts

📚 项目资源

• 项目结构：music-client/、music-manage/ 和 music-server/ 三个主要目录
• 数据库脚本：music-server/sql/tp_music.sql
• Docker配置：music-server/docker-server/docker-compose.yml
• 接口文档：可通过启动后端服务后访问 /swagger-ui.html 查看

🔍 如何获取项目

git clone https://gitcode.com/gh_mirrors/mu/music-website

通过以上解决方案，大部分常见问题都能得到快速解决。如果遇到其他问题，建议查看项目的 issue 或提交新的 issue 寻求帮助。这个开源音乐网站项目持续更新中，欢迎贡献代码和提出改进建议！