Viber结果中的性别、年龄或其他头像字段为空，首先是一个数据状态问题，而不是对账号或用户的结论。排查时应从“号码是否进入任务”开始，再沿着账号结果、头像来源、图像适用性和单字段输出逐层定位。
把缺失位置画成一条诊断链
TXT号码 → 任务结果行 → 账号字段 → 头像 → 头像分析字段。链条越靠前发生异常，影响的列通常越多；只有年龄或性别为空，则更可能位于最后的图像分析层。按照这个顺序检查，可以避免在尚未确认整行状态前就归因于头像。
症状与原因不能一一硬配
| 观察到的症状 | 优先检查 | 不要直接下的结论 |
|---|---|---|
| 整行没有结果 | 输入格式、任务状态、号码映射 | 没有Viber账号 |
| mid/昵称有值，头像为空 | 头像是否返回、可见性 | 账号虚假 |
| 头像有值，年龄/性别为空 | 图片适用性、人物清晰度 | 用户拒绝提供属性 |
| 部分图像字段有值 | 逐字段适用条件 | 其余字段为否 |
| 新旧批次不一致 | 检测日期、头像或状态变化 | 任一批次必然错误 |
服务字段可在Viber产品页面确认，更多缺失值案例见Viber性别年龄专题。
第一步：验证TXT号码真正进入任务
上传文件必须是TXT，每行一个规范化国际号码。比较唯一输入号码数与结果行数，并检查空行、重复、国家代码和非法字符。号码未进入有效任务时，后续头像解释都没有意义。
第二步：看账号层是否已经有返回
手机号、mid、昵称、活跃天数和离线时间能够帮助判断结果是否到达账号层。如果这些字段存在，而头像为空，问题范围就收窄到头像来源；如果多个账号字段也缺失，应优先查看任务异常而不是图像分析。
第三步：将头像存在与头像可分析分开
有头像不等于适合分析。风景、品牌标志、卡通、多人合照、侧脸、遮挡和低清图像都可能使年龄、性别、肤色、人数或头像类型中的部分值为空。保留头像字段和原始分析结果，不从昵称或其他资料补写。
第四步：给缺失值一个可复核的状态
- input_invalid：输入未通过格式检查。
- task_exception：任务行异常。
- avatar_not_returned：未返回头像。
- analysis_unavailable：头像存在但分析不适用或未返回。
- field_missing：某个分析字段为空。
这些状态可以放在工作表的内部列中，不应覆盖原始字段。每项异常同时保留task_id、checked_at和review_note。相关任务边界可参考Viber筛号知识中心。
什么时候值得重试
网络中断、任务明确失败或业务需要较新的观察时，可以把异常号码单独整理成TXT重试。单纯因为某个分析字段为空而不断重跑，通常不会提升证据质量。重试结果应作为新批次保存，便于解释差异。
常见问题
年龄为空可以按昵称推测吗？
不应推测。昵称不提供可靠年龄证据，也可能与真实身份无关。
性别字段为空是否要填“其他”？
不要改变原始结果。可在标准化展示列标记“未返回”，并清楚区分它与具体分类值。
为什么同一号码两次结果不同？
头像、资料和状态可能变化，两次任务的时间或可访问条件也可能不同。保留两个带日期的观察。
缺失字段多就应该删除号码吗？
不能仅凭缺失值删除业务记录。应根据原始用途、任务状态和内部数据治理规则决定。
排查的终点是说明证据停在哪里
可靠诊断不要求为每个空值编造一个用户层面的原因，而是明确号码、任务、账号、头像或分析中的哪一层没有继续返回证据。
