兽药追溯码上传失败，八成是这 4 个原因（附排查顺序）
一、按四层查，从下往上
| 层 | 典型原因 | 怎么验证 |
|---|---|---|
| 1 网络 | 产线网段访问不到平台域名 | 在采集机浏览器直连平台 |
| 2 时间 | 工控机时钟偏差超过允许范围 | 核对工控机与平台时间差 |
| 3 数据 | 必填字段缺失、编码不合规 | 导出报文逐字段核对 |
| 4 账号 | 密钥过期、企业信息未年审 | 用同账号在网页端上传一单 |
顺序不能颠倒。先查上面几层，会白花半天。
二、第 1 层：网络
最常见的情况是产线网段被限制外联，只开了内网。
- 在采集机上用浏览器打开平台登录页，能不能开
- 能开但接口报错，说明是接口白名单问题
- 正常但只在某个时段失败，看是不是网关限流
三、第 2 层：时间
追溯平台的接口普遍要求时间戳在允许偏差内（常见 ±5 分钟）。
现场做法
把工控机与 NTP 服务器同步，并在报表里记录每次上传的时间戳，便于事后核对。
四、第 3、4 层：数据与账号
数据层看三样：必填字段、编码规则、批次一致性。
账号层看两样：密钥有效期、企业资质年审状态。
| 现象 | 先查 | 典型处置 |
|---|---|---|
| 报"字段缺失" | 必填字段配置 | 补齐字段映射后重传 |
| 报"编码不合法" | 码值与编码规则 | 核对码段与校验位 |
| 报"批次不存在" | 批次是否已在平台备案 | 先备案批次再上传 |
| 报"无权限" | 密钥有效期 | 续期或换发密钥 |
| 全部成功但查不到 | 平台数据延迟 | 等待并核对查询口径 |
常见问题
上传失败是平台的问题吗？
多数不是。按网络、时间、数据、账号四层排查，通常能在前三层定位。遇到平台侧故障，可先用网页端手工上传一单验证账号有效。
离线能撑多久？
采集端应具备本地缓存，网络恢复后按序补传。缓存时长取决于数据量与磁盘，建议至少保留 72 小时。
上传失败会影响合规吗？
会。追溯数据未按时上传属于数据完整性问题。建议把上传成功率纳入日常监控，低于设定阈值即报警。
上传失败先自查，再联系平台。