拨打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')的参数
禁止出现大小写差异、多余空格这类配置错误,这类情况不会触发其他显性报错,只会直接报应用未活跃。
- Dialplan中
二、客户端连接意外断开、未保持活跃
如果执行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
相关产品推荐
相关产品推荐

