103 lines
2.1 KiB
Markdown
103 lines
2.1 KiB
Markdown
# 快速修复指南 - 音乐库唱歌视频功能
|
||
|
||
## ✅ 问题已解决！
|
||
|
||
前端代码已修复，功能现在可以正常使用了。
|
||
|
||
---
|
||
|
||
## 🎯 使用步骤
|
||
|
||
### 1. 确保后端服务运行
|
||
|
||
双击运行：`启动后端服务.bat`
|
||
|
||
或者手动运行：
|
||
```bash
|
||
cd lover
|
||
python -m uvicorn main:app --host 0.0.0.0 --port 30101 --reload
|
||
```
|
||
|
||
**验证**: 访问 http://localhost:30101/docs 应该能看到 API 文档
|
||
|
||
---
|
||
|
||
### 2. 重新编译前端
|
||
|
||
保存 `xuniYou/pages/index/index.vue` 文件后，重新编译前端项目。
|
||
|
||
---
|
||
|
||
### 3. 测试功能
|
||
|
||
1. 打开应用，进入音乐库
|
||
2. 点击任意音乐（直链或上传的音乐）
|
||
3. 确认生成
|
||
4. 等待生成完成
|
||
5. 自动切换到历史记录 tab 并播放视频
|
||
|
||
---
|
||
|
||
## 🐛 已修复的问题
|
||
|
||
### 问题 1: API 参数错误
|
||
**错误信息**: `422 Unprocessable Content - Field required: music_id`
|
||
|
||
**原因**: 前端使用 `data: { music_id }` 发送，后端期望 query 参数
|
||
|
||
**解决**: 修改为 `url?music_id={id}`
|
||
|
||
### 问题 2: 代码重复
|
||
**原因**: `selectMusicFromLibrary` 方法重复定义
|
||
|
||
**解决**: 已清理重复代码
|
||
|
||
---
|
||
|
||
## 🎯 修改后的效果
|
||
|
||
1. 点击音乐库音乐 → 弹出"生成唱歌视频"确认框
|
||
2. 确认后 → 显示"准备中..." → "生成中..."
|
||
3. 生成完成 → 自动切换到"历史记录" tab
|
||
4. 显示并播放生成的视频
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
- ✅ 直链音乐（Bensound）可以生成视频
|
||
- ✅ 用户上传的音乐可以生成视频
|
||
- ❌ 外部链接音乐（网易云、QQ音乐）会提示无法生成
|
||
|
||
---
|
||
|
||
## 🔍 如果还是不行
|
||
|
||
### 检查后端服务
|
||
|
||
```bash
|
||
# 检查端口是否被占用
|
||
netstat -ano | findstr :30101
|
||
|
||
# 应该看到类似输出：
|
||
# TCP 0.0.0.0:30101 0.0.0.0:0 LISTENING 12345
|
||
```
|
||
|
||
### 检查 API
|
||
|
||
访问：http://localhost:30101/docs
|
||
|
||
找到 `POST /music/convert-to-song`，点击 "Try it out" 测试。
|
||
|
||
### 查看浏览器控制台
|
||
|
||
按 F12 打开开发者工具，查看 Console 和 Network 标签页，看是否有错误。
|
||
|
||
---
|
||
|
||
**快速修复指南版本**: 2.0（已修复）
|
||
**创建时间**: 2026-02-04
|
||
**状态**: ✅ 问题已解决
|
||
|
||
|