MES 与 ERP 接口调用失败的排查思路

接口失败的四个层级

从外到内：网络连通 → 认证鉴权 → 参数格式 → 业务规则

分层排查

层级一：网络连通

• IP/端口是否可达（telnet 或 nc 测试）
• 防火墙是否放行
• 是否有白名单限制（很多 ERP 有 IP 白名单）

层级二：认证鉴权

• Token/密钥是否过期
• 账号是否被锁定
• 签名算法是否一致（时间戳偏差会导致签名失败）

常见坑：服务器时间不同步导致签名验证失败。务必配置 NTP。

层级三：参数格式

• 必填字段是否缺失
• 字段类型是否匹配（字符串 vs 数值）
• 日期格式（YYYY-MM-DD vs 时间戳）
• 编码问题（UTF-8 vs GBK，中文乱码）

层级四：业务规则

• 单据状态不允许当前操作（如已关闭的订单不允许报工）
• 主数据不存在（如物料未在 ERP 中创建）
• 数量超限

三个关键机制

1. 幂等设计

接口必须支持同一请求重复调用不产生重复数据。

• 用业务单号（如工单号 + 报工批次）做幂等键
• 服务端先查是否已处理过

2. 重试机制

• 失败自动重试（建议指数退避：1s、5s、30s）
• 区分可重试错误（网络超时）和不可重试错误（参数错误）
• 重试次数上限，超过进人工队列

3. 对账机制

这是最容易被忽略但最重要的：

• 每日定时比对两边数据（如报工数量、物料消耗）
• 差异自动告警
• 提供人工补单入口

日志要求

接口日志必须包含：请求时间、请求报文、响应报文、耗时、结果。没有完整日志，接口问题基本无法排查。

百华 MES 对应说明

[待补充：百华智造 MES 的接口日志位置、重试策略配置、与金蝶云星空的对接说明]