xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 16 Pull Requests 9 Actions 34.2k Packages Projects Releases 7 Wiki Activity

fix(scripts): extract-from-douyin 异常路径全部返回业务码，杜绝 500 INTERNAL_ERROR #1963

Merged
xiaoxia merged 1 commits from fix/extract-douyin-error-handling into develop 2026-09-16 13:36:47 +08:00
Conversation 2 Commits 1 Files Changed 3
+261 -6

1 Commits

Author SHA1 Message Date
xiaoxia-agent fca943428b fix(scripts): extract-from-douyin 异常路径全部返回业务码，杜绝 500 INTERNAL_ERROR
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m18s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 2m43s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m16s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 12m6s
Details
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 10s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 36s
Details 
问题：POST /api/v1/scripts/extract-from-douyin 在抖音短链无效/网络异常/ASR 兜底异常等
场景下冒泡未捕获 Exception，被全局 general_exception_handler 吞成 500 INTERNAL_ERROR，
前端无法区分业务错误。

修复（apps/api/app/api/routes/scripts_ai.py）：
1. yt-dlp 导入失败（缺依赖）→ 503（提示功能不可用）
2. yt_dlp.utils.DownloadError 单独捕获：
   - 含 404/not found/unable to download/unsupported url → 400「无法解析该抖音链接」
   - 其它网络/上游异常 → 502「视频下载失败」
3. 下载 info 成功但文件未落地（isfile False / size 0）→ 502「未获取到有效文件」
4. duration 非数字（TypeError/ValueError）→ 安全降级为 0
5. ASR 转写兜底 catch Exception → 502「语音识别失败」（原只 catch 两个自定义异常）
6. 最外层兜底 catch Exception → 500 但带具体 detail（不再是通用 INTERNAL_ERROR）
7. text/duration 提前初始化，避免异常路径 UnboundLocalError

测试：
- 新增 tests/unit/test_extract_from_douyin_errors.py，覆盖 8 个失败场景
- 更新 tests/unit/test_scripts_ai.py 三个成功/ASR 路径测试，mock os.path.isfile/getsize
- 全量单测 15531 passed
 2026-09-16 13:16:45 +08:00