背景:后端存在较多宽泛异常捕获与 print 输出,导致 silent failure 与定位成本上升。\n\n目标:统一错误分类、日志规范和失败策略(fail-fast/degrade)。\n\n范围:\n- 关键路径替换宽泛异常吞噬\n- 用统一 logger 替代 print\n- 启动/健康检查路径返回结构化错误\n\n验收标准:\n- 启动链路不再 silently swallow 错误\n- CLI/API 错误码与文案一致\n- 端口冲突/依赖缺失/模型不可达场景有自动化测试\n\n证据:仓内 except Exception 155 处、print 使用 460 处。
背景:后端存在较多宽泛异常捕获与 print 输出,导致 silent failure 与定位成本上升。\n\n目标:统一错误分类、日志规范和失败策略(fail-fast/degrade)。\n\n范围:\n- 关键路径替换宽泛异常吞噬\n- 用统一 logger 替代 print\n- 启动/健康检查路径返回结构化错误\n\n验收标准:\n- 启动链路不再 silently swallow 错误\n- CLI/API 错误码与文案一致\n- 端口冲突/依赖缺失/模型不可达场景有自动化测试\n\n证据:仓内 except Exception 155 处、print 使用 460 处。