fix: /tts/preview 解析克隆音色 UUID 为 CosyVoice voice_id #1497

Merged

auto-approve-bot merged 2 commits from fix/tts-preview-voice-clone-id into develop 2026-08-25 16:26:17 +08:00

Conversation 5 Commits 2 Files Changed 2

+214 -1

xiaoxia commented 2026-08-25 15:58:22 +08:00

Owner

Copy Link

Copy Source

问题

前端对克隆音色传的是 VoiceCloneProfile 的 id（UUID），但 CosyVoice API 需要的是 profile.voice_id（CosyVoice 返回的实际音色标识）。当前 /tts/preview 代码直接把 UUID 传给 CosyVoice，导致 418 错误。

修复

在 preview_tts 函数调用 cosyvoice_service.synthesize_speech() 之前，增加 voice_id 解析逻辑：

1. 注入 VoiceCloneProfileRepository 依赖
2. 用 request.voice_id 查询 VoiceCloneProfile
3. 命中且 voice_id 非空 → 替换为实际 CosyVoice 音色 ID
4. 命中但 voice_id 为空（克隆未完成）→ 返回 400
5. 未命中 → 预设音色 ID，保持原逻辑不变

测试

新增 3 个单元测试，全部 11 个测试通过。

## 问题 前端对克隆音色传的是 VoiceCloneProfile 的 id（UUID），但 CosyVoice API 需要的是 profile.voice_id（CosyVoice 返回的实际音色标识）。当前 /tts/preview 代码直接把 UUID 传给 CosyVoice，导致 418 错误。 ## 修复 在 preview_tts 函数调用 cosyvoice_service.synthesize_speech() 之前，增加 voice_id 解析逻辑： 1. 注入 VoiceCloneProfileRepository 依赖 2. 用 request.voice_id 查询 VoiceCloneProfile 3. 命中且 voice_id 非空 → 替换为实际 CosyVoice 音色 ID 4. 命中但 voice_id 为空（克隆未完成）→ 返回 400 5. 未命中 → 预设音色 ID，保持原逻辑不变 ## 测试 新增 3 个单元测试，全部 11 个测试通过。

xiaoxia added 1 commit 2026-08-25 15:58:23 +08:00

fix: /tts/preview 解析克隆音色 UUID 为 CosyVoice voice_id ... 7e7b73a2e1

前端传 VoiceCloneProfile UUID 作为 voice_id，但 CosyVoice 需要
profile.voice_id（实际音色标识）。当前代码直接传 UUID 导致 418 错误。

修复：
- preview_tts 注入 VoiceCloneProfileRepository 依赖
- 调用前用 request.voice_id 查询 profile
- 命中且 voice_id 非空 → 替换为实际音色 ID
- 命中但 voice_id 为空（克隆未完成）→ 返回 400
- 未命中 → 预设音色，保持原逻辑

新增 3 个测试覆盖克隆音色解析、未完成克隆、预设音色直通。

gitea-actions bot commented 2026-08-25 16:00:13 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1497
预览链接	https://pr-1497.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1497 | | 预览链接 | [https://pr-1497.preview.xiaoxiajianji.com](https://pr-1497.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-08-25 16:05:15 +08:00

fix: 补充克隆音色权限校验 + 测试 user_id mock ... 287a5dcd0f

AI Code Review 指出越权风险：未校验 VoiceCloneProfile 归属。
新增 profile.user_id != authenticated_user.user.id → 403。
补充 12 个测试全部通过。

auto-approve-bot commented 2026-08-25 16:06:59 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：2 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

1. [apps/api/app/api/routes/tts.py: 384] 缺少类型提示

   • 具体内容：建议为依赖注入的 voice_clone_repo 参数添加类型注解（例如 VoiceCloneProfileRepository），以增强代码可读性并获得更好的 IDE 静态检查支持。

2. [tests/unit/test_tts_preview.py] 减少测试代码重复

   • 具体内容：在多个测试用例（如 test_preview_tts_success, test_preview_tts_cosyvoice_error 等）中重复了相同的 mock_clone_repo 设置代码块。建议将其提取到 setUp 方法或使用 pytest fixture 来统一管理，以减少样板代码，提高测试代码的可维护性。

✅ 良好实践

• 权限校验完善：新增的逻辑正确校验了克隆音色的归属权（user_id），有效防止了越权访问（IDOR漏洞）。
• 边界条件处理：对克隆音色未完成（voice_id 为空）的情况进行了单独处理，返回了明确的 400 错误提示。
• 测试覆盖全面：新增的测试用例覆盖了预设音色透传、克隆音色解析、权限校验失败以及克隆未完成等多种场景，确保了新功能的稳定性。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-25 08:06:59 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：2 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 1. **[apps/api/app/api/routes/tts.py: 384] 缺少类型提示** - 具体内容：建议为依赖注入的 `voice_clone_repo` 参数添加类型注解（例如 `VoiceCloneProfileRepository`），以增强代码可读性并获得更好的 IDE 静态检查支持。 2. **[tests/unit/test_tts_preview.py] 减少测试代码重复** - 具体内容：在多个测试用例（如 `test_preview_tts_success`, `test_preview_tts_cosyvoice_error` 等）中重复了相同的 `mock_clone_repo` 设置代码块。建议将其提取到 `setUp` 方法或使用 pytest fixture 来统一管理，以减少样板代码，提高测试代码的可维护性。 ### ✅ 良好实践 - **权限校验完善**：新增的逻辑正确校验了克隆音色的归属权（`user_id`），有效防止了越权访问（IDOR漏洞）。 - **边界条件处理**：对克隆音色未完成（`voice_id` 为空）的情况进行了单独处理，返回了明确的 400 错误提示。 - **测试覆盖全面**：新增的测试用例覆盖了预设音色透传、克隆音色解析、权限校验失败以及克隆未完成等多种场景，确保了新功能的稳定性。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-25 08:06:59 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot approved these changes 2026-08-25 16:15:37 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-25 16:15:41 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot merged commit 41c1845aa1 into develop 2026-08-25 16:26:17 +08:00

auto-approve-bot deleted branch fix/tts-preview-voice-clone-id 2026-08-25 16:26:17 +08:00

gitea-actions bot commented 2026-08-25 16:27:22 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1497 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1497 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1497