fix(vision): #2203 V2快速路径TimeoutError未捕获+max_retries=0不生效 #2203

Merged

xiaoxia merged 1 commits from fix/vision-v2-timeout-bugs into develop 2026-10-05 17:51:39 +08:00

Conversation 2 Commits 1 Files Changed 3

+41 -24

xiaoxia commented 2026-10-05 17:50:45 +08:00

Owner

Copy Link

Copy Source

E2E发现两个P0 bug

Bug1: TimeoutError 未捕获

as_completed(timeout) 抛 TimeoutError 没被 catch，异常直接冒泡跳过 pro fallback，3/3 返回空结果。
修复：try/except TimeoutError，cancel 未完成 futures，继续走 pro VLM 兜底。

Bug2: max_retries=0 在子线程里不生效

外层_step_image_analysis设置client.max_retries=0，但ThreadPool里实际仍重试1次（2次×6s=12s超时）。
修复：vlm_fast_json/vlm_fallback内部强制max_retries=0，finally里恢复。

3. 收紧超时

fast总超时8→6s、lite JSON 6→5s、OCR 8→5s，lite不够快时尽快走pro兜底。

本地mock验证

• fast命中1.5s返回有效portrait_prompt，max_retries=0生效（仅调用1次）
• fast超时6s正确触发pro fallback

请合入后立即部署staging重跑E2E。

## E2E发现两个P0 bug ### Bug1: TimeoutError 未捕获 as_completed(timeout) 抛 TimeoutError 没被 catch，异常直接冒泡跳过 pro fallback，3/3 返回空结果。 修复：try/except TimeoutError，cancel 未完成 futures，继续走 pro VLM 兜底。 ### Bug2: max_retries=0 在子线程里不生效 外层_step_image_analysis设置client.max_retries=0，但ThreadPool里实际仍重试1次（2次×6s=12s超时）。 修复：vlm_fast_json/vlm_fallback内部强制max_retries=0，finally里恢复。 ### 3. 收紧超时 fast总超时8→6s、lite JSON 6→5s、OCR 8→5s，lite不够快时尽快走pro兜底。 ## 本地mock验证 - fast命中1.5s返回有效portrait_prompt，max_retries=0生效（仅调用1次） - fast超时6s正确触发pro fallback 请合入后立即部署staging重跑E2E。

xiaoxia added 1 commit 2026-10-05 17:50:45 +08:00

fix(vision): #2203 V2快速路径两个P0 bug修复 ... 9344314eac

E2E发现两个P0 bug：
1. as_completed(timeout=...)抛TimeoutError时未被捕获，异常直接冒泡到外层，
   跳过了pro VLM兜底路径，导致3/3返回空结果。
   修复：包裹try/except TimeoutError，cancel未完成futures，继续走pro兜底。

2. 外层_step_image_analysis设置client.max_retries=0不生效（ThreadPool线程
   里可能被其他任务覆盖/共享单例状态），实际仍重试1次（2次调用×6s=12s超时）。
   修复：在vlm_fast_json/vlm_fallback内部强制max_retries=0并在finally里恢复。

3. 收紧超时：fast总超时8→6s、lite JSON 6→5s、OCR 8→5s，让lite不够快时
   尽快走pro兜底（pro单次45s足够）。

本地mock验证：fast命中1.5s返回有效portrait_prompt；fast超时6s正确触发pro fallback。

xiaoxia merged commit 12b0d15473 into develop 2026-10-05 17:51:39 +08:00

xiaoxia referenced this issue from a commit 2026-10-05 17:51:40 +08:00

fix(vision): #2203 V2快速路径两个P0 bug修复

gitea-actions bot commented 2026-10-05 17:52:24 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

gitea-actions bot commented 2026-10-05 17:55:09 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#2203