# EDI 故障排查手册

> 排查顺序：先确认方向（入站还是出站）→ 再看通道 → 再看报文 → 最后看业务校验。
> 永远先看原始报文和回执，不要凭印象判断。

## 1. 买方说发了，我方没收到

**AS2**
1. 查访问日志：有没有对应时间段的 POST 请求
2. 无请求：买方出口 IP 是否在白名单、WAF 是否拦截、DNS/证书是否异常
3. 有请求但 401/403：AS2 ID 或 URL 路径不匹配
4. 有请求但报错：看验签/解密异常，通常是证书或算法问题

**SFTP**
1. 查 `in/` 目录是否有文件（注意是否只有 `.tmp`）
2. 查账号是否被锁、磁盘是否满
3. 查文件权限与属主

## 2. 报文解析失败（997 Reject）

1. 打开原始报文，先看 ISA 段是否完整（固定 106 字符，结尾是段分隔符）
2. 核对分隔符：元素、段、子元素分隔符是否与代码假设一致
3. 对照 IG 检查必填字段、字段长度、日期格式、代码表
4. 看 997 的 `AK4`：段位置、段标识、元素位置、错误代码
5. 常见错误代码：
   - `1` 必填字段缺失
   - `4` 数据格式错误
   - `6` 代码值不在允许列表
   - `7` 字段长度超限

## 3. 我方发了，买方说没收到

1. 看 HTTP 状态码：连接超时 / 502 / 401 各自含义不同
2. 是否收到 MDN：没有 MDN 基本等于没送达
3. 出口 IP 是否在买方白名单（最常见原因）
4. 证书是否被买方信任、签名算法是否兼容
5. 报文是否超出买方大小限制

## 4. 收到 MDN 成功，但买方业务系统拒收

传输层已通，问题在业务报文：

1. 856：SSCC 是否正确（18 位、含校验位）、箱数与明细是否一致、托盘层级是否完整
2. 810：金额、税额、数量是否与 856 匹配
3. 物料编码是否使用了买方要求的编码（不是自家 SKU）
4. 单位、日期、地址结构是否符合 IG
5. 是否有买方要求的附加段缺失（如 REF、DTM、PID）

## 5. 重复报文与重复建单

1. 检查 `partner + control_no` 唯一约束是否生效
2. 买方重传时控制号是否复用（复用应判重，不复用视为新单）
3. 文件型通道检查是否已归档，避免同一文件被二次消费

## 6. 回执超时

1. 先确认对方是否真的收到（看对方日志或询问）
2. 重试是否有上限，避免把买方防火墙打爆
3. 超时后是否已告警，状态是否置为 `AckTimeout`
4. 同步 MDN 场景注意长事务超时设置

## 7. 证书相关

| 报错关键词 | 处理 |
|---|---|
| certificate expired | 更新证书并通知买方 |
| unknown ca / unable to get issuer | 补中间证书链 |
| signature verification failed | 核对签名算法与证书是否配对 |
| decryption failed | 核对加密算法与公钥 |

## 8. 跨境链路问题

现象：间歇性超时、连接重置、MDN 偶发收不到。

1. 优先把服务部署到海外节点（美西 / 新加坡 / 法兰克福）
2. 检查出口带宽与并发限制
3. 调整重试间隔，避免高峰叠加
4. 必要时用固定 EIP，减少路由抖动

## 9. 排查记录模板

| 项 | 内容 |
|---|---|
| 发生时间 | |
| 方向 / 报文类型 | |
| 报文控制号 | |
| 现象 | |
| 定位到的层（通道 / 报文 / 业务） | |
| 根因 | |
| 处理动作 | |
| 是否需通知买方 | |
