jev上线之后如果性能突然掉下来，先别急着乱改提示词，照着流量、state长度、问题版本、网关状态、阈值变动、业务样本漂移这六条线顺藤摸瓜查就行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
上面这张图截自Jev API Reference页面，后面内容全是接口调用相关的线上排查实操流程。
性能下降通常不是单点问题
刚上线的时候跑的好好的，过了几天突然变慢，或者误判率飙升，大概率不是单一因素导致的。常见诱因有流量结构变了、state字段撑大了、问题描述被修改、缓存命中率掉下来、网关触发限流，或是业务样本出现漂移。要是没留全日志，很容易错怪是模型本身出问题了。
先区分速度下降和质量下降
先把两类问题分开：速度异常就看接口耗时、429报错、超时情况和state长度；质量异常就看人工改判率、灰区占比和各个结果选项的分布。这两类的处理思路完全不一样：速度有问题优先做降级削峰，质量有问题优先回滚问题版本或者调整阈值。
六条排查线
- 看流量：核对请求量、各业务来源的占比有没有异常波动。
- 看输入：检查state字段的字符数是不是莫名变长了。
- 看版本：确认最近有没有刚改过questions配置或者阈值参数。
- 看网关：统计429、5xx这类报错和超时请求的占比是不是上涨了。
- 看分布：核对other分类、灰区、人工复核的占比有没有超出正常区间。
- 看样本：是不是有之前没覆盖过的新业务类型，进了老的问题集里。
下降类型与应急动作
| 下降类型 | 典型信号 | 应急动作 |
|---|---|---|
| 速度下降 | p95、超时、429 上升 | 限流、缓存、降级 |
| 质量下降 | 人工改判率上升 | 回滚问题版本 |
| 成本上升 | state 变长 | 压缩输入 |
应急时不要同时改太多
线上出故障的时候最忌讳手忙脚乱同时改state、判定规则、阈值、缓存好几个地方。先把影响用户的高风险动作切去降级，再回滚最近一次的配置变更，最后用固定的基准样本复盘校验。一次只动一个变量，才能准确定位到真正的问题点。
应急时先冻结变量
性能刚出问题的第一时间，先别急着改判定规则，先把当前在用的问题版本和阈值锁死，别边查边改把环境搞乱。先把高风险的业务动作做降级兜底，再依次查state长度、流量来源、错误码、模型耗时这些指标。
等确认了根因之后再做单点调整，才能明确判断修复操作有没有真的生效。
| 步骤 | 动作 | 目的 |
|---|---|---|
| 冻结 | 锁定版本 | 避免复盘混乱 |
| 降级 | 保护高风险动作 | 先止损 |
| 定位 | 查日志和样本 | 找到根因 |
应急完成后必须补复盘
等性能恢复正常之后，别直接就把这事翻篇了，一定要补一份完整的复盘记录：要写清楚故障开始的时间、影响范围、触发条件、临时做的降级动作、最终定位的根因，还有后续要补的预防措施。
Jev是跑在控制面的，任何一点性能波动都可能直接影响线上业务流程，这份复盘记录的价值比临时修故障高得多。
一次线上下降的处理样例
举个真实场景：某天上午十点之后other分类的占比突然翻了一倍，先去查是不是有新的业务入口接入了同一套questions配置。如果是新入口传过来的state字段缺了必要的历史状态，先把这个新入口的流量切去人工兜底或者旧规则跑，补全缺失的字段之后再回放验证。
别为了快速压下other占比就直接随便扩大Choice选项范围，不然把原本跑的好好的老入口的稳定性也给拖垮了。
恢复后的二次检查
应急恢复后的24小时里，一定要再翻一遍错误率和超时的曲线，确认不是靠临时降级把问题暂时盖住了。
如果前端用户访问已经正常了，但人工审核队列的积压量突然涨上去，说明系统只是把风险转嫁给了人工，根因还没解决，得接着优化state字段、阈值或者限流策略，最后把这次排查的经验也补进复盘记录里。
性能告警字段示例
const jevMetric = {
requestId: 'req_001',
questionVersion: 'route_v4',
stateSize: 1820,
latencyMs: 940,
status: 200,
fallback: false,
distributionDrift: 'other_rate_up',
};应急坑点
- 边降级边改问题描述，最后复盘的时候根本理不清哪步操作导致了什么结果。
- 只盯着模型侧的耗时统计，忽略了业务端感知到的实际等待时长。
- 没提前埋点统计state字段长度，出问题了根本发现不了输入量膨胀的问题。
- 没给问题配置留版本号，出问题的时候没法快速回滚止损。
应急方案
性能突然掉下来的时候，先优先保用户侧的访问体验：高风险请求切人工兜底，低风险请求走预定义规则或者缓存返回。等整个链路跑稳了，再翻日志和样本定位根因，绝对别直接在线上盲调参数。
