# P9→NS1/RNS1 缺失项 #22:详情页各模块的加载失败独立处理 ## 简要结论 - 状态:✅ 已解决 - 风险等级:🟢 低 - 后端对每个扩展模块使用独立 try/except 优雅降级;前端 customer-service-records 也实现了模块级独立错误处理 ## 详细审查 ### 审查范围 - `apps/backend/app/services/customer_service.py` — `get_customer_detail()` 错误处理 - `apps/backend/app/services/coach_service.py` — `get_coach_detail()` 错误处理 - `apps/miniprogram/miniprogram/pages/customer-service-records/customer-service-records.ts` — 前端错误处理 ### 发现 #### 后端 — customer_service.py 1. 核心字段(member_info)查询失败 → 直接抛 500/404 2. Banner 字段(balance、consumption_60d、days_since_visit)各自独立 try/except,失败降级为 `None` 3. 扩展模块(ai_insight、retention_clues、notes、consumption_records、coach_tasks、favorite_coaches)各自独立 try/except,失败降级为空默认值 4. 注释明确标注:"核心字段查询失败 → 500;扩展模块查询失败 → 空默认值(优雅降级)" #### 后端 — coach_service.py 1. 核心字段(assistant_info)查询失败 → 直接抛 500/404 2. 扩展模块(income、tier_nodes、top_customers、service_records、task_groups、notes、history_months)各自独立 try/except 3. 每个模块失败时 logger.warning 记录日志,降级为空默认值 #### 前端 — customer-service-records.ts 1. `loadCustomerInfo()` 失败不阻塞记录展示:`catch` 中仅 `console.error`,注释"客户信息加载失败不阻塞记录展示" 2. `loadMonthRecords()` 失败设置 `pageState: 'error'`,提供重试按钮 ### 证据 ```python # customer_service.py — 每个模块独立 try/except try: ai_insight = _build_ai_insight(customer_id, conn) except Exception: logger.warning("构建 aiInsight 失败,降级为空", exc_info=True) ai_insight = {"summary": "", "strategies": []} try: retention_clues = _build_retention_clues(customer_id, conn) except Exception: logger.warning("构建 retentionClues 失败,降级为空列表", exc_info=True) retention_clues = [] ``` ```python # coach_service.py — 同样的模式 try: income = _build_income(conn, site_id, coach_id, now) except Exception: logger.warning("构建 income 失败,降级为空", exc_info=True) income = {"this_month": [], "last_month": []} ``` ```typescript // customer-service-records.ts — 客户信息加载失败不阻塞 async loadCustomerInfo(id: string) { try { ... } catch (err) { console.error('[customer-service-records] loadCustomerInfo failed:', err) // 客户信息加载失败不阻塞记录展示 } } ``` ### 建议 - 前端 customer-detail.ts 的 `loadDetail()` 目前是单一 try/catch,所有数据在一个请求中获取。如果后端某个模块降级为空,前端会正常展示空状态,但如果整个 API 请求失败,所有模块都不可用。这是可接受的设计,因为核心数据和扩展数据在同一个 API 调用中返回。