You need to enable JavaScript to run this app. 拨打Asterisk分机时报错Stasis应用未激活如何排查解决?
优惠活动
大模型
产品
解决方案
定价
更多

拨打Asterisk分机时报错Stasis应用未激活如何排查解决?

Asterisk 报错 stasis app not active 排查与解决

该报错的核心触发逻辑是:Dialplan执行到Stasis()指令时,没有查询到 已成功连接Asterisk、完成注册且处于活跃状态 的同名Stasis应用,以下按排查优先级列对应的成因与解决方法:

一、最常见成因:ARI客户端未成功注册应用

排查步骤

首先在Asterisk命令行执行:
ari show applications
该命令会直接列出当前Asterisk已识别的所有活跃Stasis应用,如果输出中没有配置的example,说明客户端没有成功注册,对应排查方向:

  • 确认Asterisk侧ARI服务已启用
    检查/etc/asterisk/ari.conf配置,确保全局配置enabled = yes,且配置了合法的登录用户、密码、允许访问的IP段,示例:
    [general]
    enabled = yes
    [ari_user]
    type = user
    username = ari_user
    password = 自定义的登录密码
    allowed_origins = 客户端所在IP段
    
    配置修改完成后执行重载命令:asterisk -rx "module reload res_ari",再执行以下命令验证服务是否正常:
    curl -u ari_user:自定义密码 http://Asterisk服务IP:8088/ari/applications
    返回正常JSON结构即说明ARI服务对外可访问。
  • 确认客户端进程正常运行
    检查example.js进程是否处于运行状态,是否存在启动即崩溃的情况,查看客户端自身运行日志,是否有连接Asterisk超时、401未授权、端口不通的报错。
    注意:默认ARI端口为8088,需要提前放行防火墙规则,允许客户端IP访问该端口。
  • 确认应用名完全匹配
    三处配置的应用名必须 完全一致(严格区分大小写、无多余空格):
    • Dialplan中Stasis()的参数:Stasis(example)
    • ARI客户端连接成功后调用的ari.start('example')的参数
      禁止出现大小写差异、多余空格这类配置错误,这类情况不会触发其他显性报错,只会直接报应用未活跃。

二、客户端连接意外断开、未保持活跃

如果执行ari show applications能看到example应用,但拨测还是报错,优先排查:

  • 客户端进程是否在注册后意外退出,或者网络波动导致连接中断,Asterisk侧的应用注册记录已失效。
  • 客户端未配置自动重连机制,如果Asterisk侧重载了ARI模块、或者Asterisk服务重启,原有连接断开后客户端没有自动重连重新注册应用。
    解决方法:用系统级进程托管工具(比如systemd、pm2)常驻客户端进程,配置进程异常退出自动拉起,同时在客户端代码中增加ARI连接断开后的自动重连逻辑。

三、其他配置异常

  • 检查Stasis相关模块是否正常加载:执行asterisk -rx "module show like stasis",确认res_stasis.so模块状态为Running,如果未加载则手动执行asterisk -rx "module load res_stasis.so"。
  • 确认Dialplan的上下文配置正确,通道确实执行到了Stasis()指令而非前面的分支提前挂断,打开Asterisk详细日志asterisk -rvvv后再拨测,确认日志中能看到通道进入Stasis(example)的记录。

内容的提问来源于stack exchange,提问作者live-love

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 18:15:05