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)或接通超时。
⚠️ 注:虽归类为程序挂机,但根源通常在网关/线路