fix(backend): #1867 对口型卡running三层防御修复（rebase到最新develop） #1916

Merged

auto-approve-bot merged 5 commits from fix/1867-lipsync-triple-defense-rebased into develop 2026-09-15 03:35:30 +08:00

Conversation 2 Commits 5 Files Changed 5

+633 -43

xiaoxia commented 2026-09-15 02:10:46 +08:00

Owner

Copy Link

Copy Source

背景

旧PR #1867 分支基于老develop，存在大量冲突无法自动合并。本PR基于最新develop重新应用三层防御修复，保留所有已合入的lipsync优化（#1845 TTS预合成、#1849 import修复、#1864 封面/cv2依赖）。

三层防御

1. 前端轮询层：GET /lipsync/jobs/{id} 中，若距上次更新超过30秒，同步调用 refresh_job_status（避免 FastAPI BackgroundTasks 静默失败导致前端永远看到 running），否则仍后台异步刷新
2. DB层：refresh_job_status 中 DB commit 包 try/except 并 rollback，防止提交异常导致后续轮询链路断裂
3. Worker层：TTS 合成并提交 MediaKit 成功后，链式触发 Celery 兜底轮询任务 poll_mediakit_status（最多60次×10秒=10分钟），不依赖前端轮询

测试

• 本地 102 个lipsync相关单测全部通过
• 覆盖原有lipsync_routes/lipsync_tts/lipsync_tts_preview/ai_avatar等测试

Closes #1867

## 背景 旧PR #1867 分支基于老develop，存在大量冲突无法自动合并。本PR基于最新develop重新应用三层防御修复，保留所有已合入的lipsync优化（#1845 TTS预合成、#1849 import修复、#1864 封面/cv2依赖）。 ## 三层防御 1. **前端轮询层**：GET /lipsync/jobs/{id} 中，若距上次更新超过30秒，同步调用 refresh_job_status（避免 FastAPI BackgroundTasks 静默失败导致前端永远看到 running），否则仍后台异步刷新 2. **DB层**：refresh_job_status 中 DB commit 包 try/except 并 rollback，防止提交异常导致后续轮询链路断裂 3. **Worker层**：TTS 合成并提交 MediaKit 成功后，链式触发 Celery 兜底轮询任务 poll_mediakit_status（最多60次×10秒=10分钟），不依赖前端轮询 ## 测试 - 本地 102 个lipsync相关单测全部通过 - 覆盖原有lipsync_routes/lipsync_tts/lipsync_tts_preview/ai_avatar等测试 Closes #1867

xiaoxia added 1 commit 2026-09-15 02:10:46 +08:00

fix(backend): #1867 对口型卡running三层防御修复（rebase到最新develop） ... 8092d60111

三层防御:
1. 前端轮询 GET /lipsync/jobs/{id}：距上次更新超过30秒时同步刷新一次（避免 background task 静默失败永久卡 running），否则后台异步刷新
2. refresh_job_status：DB commit 包 try/except 并 rollback，防止 DB 提交失败导致后台任务静默失败
3. TTS Celery 任务：MediaKit 提交成功后链式触发 poll_mediakit_status 兜底轮询任务（worker主动拉状态，最多60次×10s=10分钟，不依赖前端轮询）

解决冲突: rebase 到最新 develop（含 #1845/#1849/#1864 等已合并的lipsync优化），保留同步转存/异步转存/预合成等已有功能

Refs #1867

xiaoxia referenced this pull request 2026-09-15 02:10:57 +08:00

fix(lipsync, P0): 对口型卡running三层防御修复 #1867

gitea-actions bot commented 2026-09-15 02:12:11 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-09-15 02:15:02 +08:00

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] 425018ecc0

xiaoxia added 1 commit 2026-09-15 02:58:01 +08:00

test(#1867): 补充三层防御单测提覆盖率到 CI 阈值 ... 4c4d4b76c5

- Layer 1 (routes): stale>30s 同步刷新 / fresh 后台刷新 / completed 跳过 /
  同步异常 fallback 到 background / 404 共 5 个分支
- Layer 2 (service): DB commit 异常 rollback + 中间态 commit + failed 写
  error_info 共 3 个分支
- Layer 3 (worker): poll_mediakit_status 新任务 10 个分支 (not found /
  终态跳过 / 无 mk_task_id / succeeded→completed+persist / persist 失败回退
  temp_url / failed / error / running→retry) + tts 提交成功链式触发 poll
  3 个分支 (成功 dispatch / 失败不 dispatch / dispatch 异常不影响主流程)
- 共 21 个新测试，全量 15126 passed。

[skip ci-format-check]

xiaoxia added 1 commit 2026-09-15 03:12:37 +08:00

style(#1867): isort 修复 test_lipsync_routes 导入顺序 ... cd087f272b

[skip ci-format-check]

xiaoxia added 1 commit 2026-09-15 03:25:41 +08:00

fix(#1867): B904 raise-without-from 合规（Celery retry 异常链） ... 85832396d5

- 两个 raise self.retry(exc=exc) 追加 from exc 满足 ruff B904 规则

auto-approve-bot merged commit 695a491c5d into develop 2026-09-15 03:35:30 +08:00

auto-approve-bot deleted branch fix/1867-lipsync-triple-defense-rebased 2026-09-15 03:35:30 +08:00

gitea-actions bot commented 2026-09-15 03:36:06 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1916