传真呼叫流程与失败码解读
#前置：失败发生在 T.30 的哪一个阶段
回顾 T.30 五阶段，绝大多数失败集中在这三处：
- 阶段A（呼叫建立）：拨号不通、无载波、对方不接、空号、停机；
- 阶段B（能力协商）：握手成功，但双方能力无法对齐（分辨率、ECM、速率、压缩算法不兼容）；
- 阶段C（图像传输）：协商通过，传输中途丢包、噪声、重传超时，连接中断。
一个核心判断原则：振铃并接通 = 呼叫建立成功；接通之后断线，基本是协商或传输问题；直接报无载波/无法接通，属于线路与被叫侧问题。
#通用基础状态文本（平台高频返回）
#No Carrier（无载波）
业务含义：成功拨号、线路接通，但没有收到远端传真Modem的传真载波信号。 根因分类：
- 被叫不是传真机：是普通座机、手机、自动语音、IVR、语音留言；
- 对方传真机故障、关机、离线；
- 线路音频异常：VoIP 开启语音压缩、VAD静音抑制，载波被破坏；
- 跨境中继路由问题，载波信号在网关转换时丢失。 业务提示：对方号码是传真号 ≠ 对方设备一定处于传真就绪状态。
#Negotiation Failed（协商失败）
业务含义：收到对方DIS能力报文，但是找不到双方都支持的参数交集，握手阶段B终止。 根因分类：
- 对方老旧设备不支持 Super Fine、V.34高速、ECM；
- 压缩算法（MMR）对方不兼容；
- T.38协商失败，网关无法完成T.30信号转换； 业务提示：优先降级参数：降低分辨率、关闭ECM、禁用V.34。
#Training Failed（训练失败）
业务含义：T.30速率训练（信号同步测速）失败。 根因分类：线路噪声大、IP抖动/丢包、跨境时延过高；两端Modem无法同步调制速率。 常见伴随：可以接通，但是训练反复重试，最后挂断。
#平台通用数字失败码（20/21/22/34/45 等）
说明：这一组是云传真网关行业最通用的业务码，不同厂商实现一致度较高。
#20 | No Answer / 无应答
业务含义：拨号成功，有振铃，但是等待超时，对方一直无人/无设备应答。 根因分类：
- 传真机无人值守、未开启自动接收；
- 对方设置了人工接听，没人手动切换到传真模式；
- 被叫线路繁忙、呼叫转移到语音。 业务提示：外贸客户时差问题高发；可以换时段重试。
#21 | Busy / 线路忙
业务含义：拨号后直接返回忙音。 根因分类：对方线路正在通话、传真机正在收发、线路被占用；部分企业PBX外线不足。 业务提示：短间隔重试，批量任务建议退避间隔，不要高频轰炸。
#22 | No Carrier（无载波，和上面文本状态对应）
业务含义：接通但是没有检测到传真Modem载波信号。 根因参考上文 No Carrier。
#34 | Protocol Error / T.30协议错误
业务含义：T.30会话时序错乱，收到非法报文、报文丢失、报文顺序错位。 根因分类：
- T.38 UDP丢包、乱序；
- 防火墙NAT会话超时，中间报文被丢弃；
- 远端网关固件bug，T.30报文封装异常； 跨境链路这个码非常常见。 业务提示：属于网络层问题，重试有概率成功；持续出现建议切换G.711透传降级。
#45 | Page Transfer Timeout / 页面传输超时
业务含义：协商握手全部成功，已经开始传图，但是传输长时间没有收到远端确认，T.30计时器超时断开。 根因分类：
- ECM模式下大量分片重传，持续失败，耗尽重试次数；
- 跨境链路高时延、连续丢包；
- 对方设备性能弱，处理图像太慢，应答回包超时。 业务提示：这个是跨境长文档高频失败码；处理方案：关闭ECM、降低分辨率、拆分成多页任务。
#其他高频辅助失败码
#30 | Invalid Number / 号码无效
业务含义：号码格式错误、国家码缺失、E.164格式不合法、号码不存在。 根因分类：号码少国家码、带多余符号、国别路由不支持该号段。 业务提示：外贸号码必须规范E.164格式，+开头。
#31 | Call Rejected / 呼叫被拒绝
业务含义：运营商中继、被叫侧PBX、网关直接拒绝本次呼叫。 根因分类：对方号码拉黑你的主叫DID、运营商风控拦截、部分国家对境外呼叫限制。 业务提示：换本地DID呼出，降低被拦截概率。
#40 | ECM Retry Exhausted / ECM重传耗尽
业务含义：ECM开启，多个数据块校验失败，反复PPR重传直到上限，会话终止。 根因分类：线路噪声、IP丢包；ECM对差链路很不友好。 业务提示：国内稳定链路开ECM；跨境反复报40，优先关闭ECM重试。
#50 | Gateway Error / 网关内部错误
业务含义：发送侧服务商网关异常，不属于远端客户问题。 根因分类：网关资源耗尽、中继故障、T.38网关进程异常。 业务提示：属于平台侧故障，用户短时间重试不一定有效，需要服务商排查中继。
#按故障大类快速归类（方便客服直接定位）
- 呼叫建立类（A阶段）：20、21、30、31 特征：握手还没开始；问题集中在号码、振铃、运营商路由、被叫设备是否在线。
- 协商握手类（B阶段）：Negotiation Failed、Training Failed 特征：能接通，但是无法达成参数共识；问题集中在两端设备能力、T.38协商。
- 传输中断类（C阶段）：22、34、45、40 特征：握手成功，传一部分断线；绝大多数是IP网络抖动、丢包、ECM重传超时，跨境最高发。
- 平台网关类（50） 特征：和被叫无关，服务商侧中继/网关故障。
#典型场景举例，帮助理解
- 给美国客户发传真，返回45：握手成功，传到一半超时 → 跨境链路差，ECM反复重传超时；建议关闭ECM、Fine分辨率重试。
- 发给老旧医院传真机，返回Negotiation Failed → 老设备不支持V.34/Super Fine，降速、降分辨率。
- 一直返回No Carrier：号码是语音总机，不是独立传真线，IVR会吃掉传真载波。
- 同一批任务，国内全部成功，美国号码大量34：跨境T.38 UDP丢包，运营商对UDP流量限制。
#常见误区澄清
- ❌ 同一个错误码，一定是同一个原因 更正：错误码是网关观察到的现象，不是根因；例如34协议错误，可能是防火墙，也可能是远端网关bug。
- ❌ Training Failed 等于对方设备坏了 更正：更多是VoIP链路压缩、抖动，不是对方机器故障。
- ❌ 45超时，代表对方收到一半文件 更正：有可能对方收到部分图像，但会话已经中断，文件不完整，平台判定发送失败。
- ❌ T.38开启就不会报34协议错误 更正：T.38只是封装方式，UDP本身丢包、乱序依然会触发T.30协议报错。