Skip to main content

挂机原因对照表

 

FreeSWITCH 挂机原因对照表(Originate/Hangup Cause),已按常见类别归纳,并给出中文含义与简要说明,便于排查外呼失败、挂断分析、日志解读。


FreeSWITCH 挂机原因对照表

代码(常量名)

中文解释

说明

NONE​

无

无挂机原因(初始状态)

SUCCESS​

成功

呼叫成功建立

NORMAL_CLEARING​

正常挂断

通话正常结束

ORIGINATOR_CANCEL​

主叫取消

主叫方主动挂断

USER_BUSY​

用户忙

对方正在通话中

BUSY_EVERYWHERE​

全忙

SIP 486 Busy Everywhere

NO_ANSWER​

无应答

振铃超时未接听

NO_USER_RESPONSE​

用户无响应

未收到用户响应

CALL_REJECTED​

呼叫被拒绝

对方拒接

DECLINE​

明确拒绝

SIP 603 Decline

DOES_NOT_EXIST_ANYWHERE​

号码不存在

SIP 604 Does Not Exist Anywhere

UNALLOCATED_NUMBER​

未分配号码

号码不存在

INVALID_NUMBER_FORMAT​

号码格式非法

拨号格式错误

NUMBER_CHANGED​

号码已变更

号码迁移

REDIRECTION_TO_NEW_DESTINATION​

重定向到新目的地

呼叫被重定向

NO_ROUTE_DESTINATION​

无路由可达

找不到出局路由

NO_ROUTE_TRANSIT_NET​

无转接路由

中转网络不可达

INVALID_GATEWAY​

网关无效

网关配置错误

GATEWAY_DOWN​

网关不可用

网关宕机或未注册

INVALID_PROFILE​

配置文件无效

SIP Profile 错误

INVALID_URL​

URL 非法

请求地址错误

DESTINATION_OUT_OF_ORDER​

目的地故障

终端或线路异常

SUBSCRIBER_ABSENT​

用户不在服务区

无法接通

SERVICE_UNAVAILABLE​

服务不可用

SIP 503

NETWORK_OUT_OF_ORDER​

网络故障

网络层异常

NORMAL_CIRCUIT_CONGESTION​

电路拥塞

中继/信道满

SWITCH_CONGESTION​

交换机拥塞

FS 资源不足

NORMAL_TEMPORARY_FAILURE​

临时故障

可重试

REQUESTED_CHAN_UNAVAIL​

请求通道不可用

通道资源不足

BEARERCAPABILITY_NOTAVAIL​

承载能力不可用

Codec / 媒体不支持

BEARERCAPABILITY_NOTIMPL​

承载能力未实现

不支持的媒体类型

INCOMPATIBLE_DESTINATION​

不兼容的目的地

协议或能力不匹配

PROTOCOL_ERROR​

协议错误

SIP / SDP 异常

INVALID_MSG_UNSPECIFIED​

非法消息

未知信令错误

MANDATORY_IE_MISSING​

必选信息缺失

信令不完整

WRONG_CALL_STATE​

错误呼叫状态

状态机异常

RECOVERY_ON_TIMER_EXPIRE​

定时器超时恢复

超时导致释放

PROGRESS_TIMEOUT​

进展超时

183 / 180 后无进展

ALLOTTED_TIMEOUT​

分配超时

最大等待时间耗尽

MEDIA_TIMEOUT​

媒体超时

RTP 丢失

SRTP_READ_ERROR​

SRTP 读取错误

加密媒体失败

PICKED_OFF​

被抢接

被其他设备接走

NO_PICKUP​

无人接听

Pickup 失败

BLIND_TRANSFER​

盲转

盲转移挂断

ATTENDED_TRANSFER​

咨询转

咨询转移挂断

MANAGER_REQUEST​

管理操作

API / 控制台挂断

SYSTEM_SHUTDOWN​

系统关闭

FreeSWITCH 重启

CRASH​

崩溃

进程异常退出

LOSE_RACE​

竞争失败

多路呼叫冲突

BOWOUT​

退出处理

策略性放弃

REJECT_ALL​

全部拒绝

策略拦截

UNWANTED​

不受欢迎呼叫

黑名单/反骚扰

USER_NOT_REGISTERED​

用户未注册

SIP 注册失效

CHANNEL_UNACCEPTABLE​

通道不可接受

策略拒绝

FACILITY_REJECTED​

功能被拒绝

业务不支持

ACCESS_INFO_DISCARDED​

接入信息丢弃

鉴权或策略失败

PRE_EMPTED​

被抢占

高优先级呼叫抢占

INTERWORKING​

互通问题

异网互通失败

 

程序主动挂机 & AI 服务异常对照表

代码 (Code)

中文解释

详细说明与排查建议

llm_api_server_error​

LLM 服务响应异常

大语言模型(如 OpenAI、私有化模型)返回了非 200 状态码或异常报文。
✅ 检查 LLM 服务端健康状态。

llm_api_key_incorrect​

LLM 鉴权密钥错误

API Key 无效、过期或被禁用。
✅ 检查配置文件中的 api_key是否正确。

llm_api_network_error​

LLM 网络请求失败

调用 LLM API 时发生网络超时、DNS 解析失败或连接中断。
✅ 检查服务器出口网络、防火墙及代理设置。

system_internal_error​

系统内部错误

程序发生未捕获的异常、空指针、线程死锁等致命错误。
✅ 查看 Java 堆栈日志(Stack Trace)。

asr_account_info_incorrect​

ASR 账号信息错误

语音识别(ASR)的 AppKey、Secret 或 Token 配置错误。
✅ 核对 ASR 服务商控制台信息。

tts_account_info_incorrect​

TTS 账号信息错误

语音合成(TTS)的账号鉴权失败。
✅ 检查 TTS 余额是否耗尽或账号欠费。

tts_server_connected_failed​

TTS 服务连接失败

无法建立到 TTS 服务器的 TCP/HTTP 连接。
✅ 检查 TTS 域名/IP 是否可达。

asr_server_connected_failed​

ASR 服务连接失败

无法连接至语音识别服务器。
✅ 常见于内网隔离或 ASR 服务宕机。

Exceed-callTimeOut​

呼叫超时(网关无应答)

程序侧等待网关回铃(Ringing)或接通超时。
⚠️ 注:虽归类为程序挂机,但根源通常在网关/线路。