问题背景

在 FreeSWITCH 中使用 mod_xml_curl 模块可实现通过 HTTP 接口动态加载用户配置，适用于灵活的用户管理场景。然而，在启用该模块进行 SIP 用户注册与呼叫控制时，虽然软电话可以成功注册并实现分机互拨，但在执行 originate user/1234 &echo() 等拨号操作时却出现如下错误：

originate user/1234 &echo()
-ERR MANDATORY_IE_MISSING

[ERR] mod_dptools.c:4218 No dial-string available, please check your user directory.

此错误表明系统无法获取目标用户的拨号字符串（dial-string），导致呼叫流程中断。

根本原因分析

当 FreeSWITCH 使用本地 XML 配置文件（如 directory/default.xml）加载用户信息时，每个用户节点中默认包含一个名为 dial-string 的参数，用于定义如何建立外呼连接。而使用 mod_xml_curl 时，若远程接口返回的 XML 数据未显式包含该参数，则系统将因缺少必要路由信息而报错。

尽管用户能正常注册，说明认证和基本配置已生效，但发起呼叫属于独立的 IVR 流程，依赖完整的 dial-string 构造 sofia 或 verto 协议的终端地址。因此必须确保动态返回的 XML 包含正确的 <param name="dial-string"> 字段。

解决方案：补全 dial-string 参数

需在鉴权 API 返回的 XML 响应中添加标准的 dial-string 定义。以下是修正后的完整示例：

<document type="freeswitch/xml">
    <section name="directory">
        <domain name="172.26.129.54">
            <user id="1234">
                <params>
                    <param name="password" value="password1234"/>
                    <param name="vm-password" value="1234"/>
                    <param name="dial-string" 
                          value="{^^:sip_invite_domain=${dialed_domain}:presence_id=${dialed_user}@${dialed_domain}}${sofia_contact(*/${dialed_user}@${dialed_domain})},${verto_contact(${dialed_user}@${dialed_domain})}"/>
                    <param name="auth-acl" value="192.168.1.100/32,192.168.2.0/24,10.0.0.1/32"/>
                </params>
                <variables>
                    <variable name="toll_allow" value="domestic,international,local"/>
                    <variable name="accountcode" value="5364"/>
                    <variable name="user_context" value="default"/>
                    <variable name="effective_caller_id_name" value="Extension 1234"/>
                    <variable name="effective_caller_id_number" value="1234"/>
                    <variable name="outbound_caller_id_name" value="$${outbound_caller_name}"/>
                    <variable name="outbound_caller_id_number" value="$${outbound_caller_id}"/>
                    <variable name="callgroup" value="techsupport"/>
                </variables>
            </user>
        </domain>
    </section>
</document>

关键配置说明

• domain name：必须与 FreeSWITCH 发起请求时传递的 domain 参数一致。通常为服务器内网 IP 或域名，若 API 与 FS 不在同一主机，需确保两者识别的域匹配，否则会导致配置查找失败。
• user id：设置为实际的分机号码，如 "1234"。
• dial-string：不可或缺，决定了呼叫发起时使用的协议（Sofia/Verto）及联系地址生成方式。上述值兼容主流 VoIP 场景。
• auth-acl：指定允许注册的客户端源 IP 列表，支持 CIDR 格式，多个地址以逗号分隔。例如仅允许来自特定办公网络或公网设备接入。

调试建议

当遇到配置未生效或功能异常时，推荐对比原始静态 XML 文件与动态返回内容的结构差异，重点检查 params 节点下的隐式依赖项。可通过开启 FreeSWITCH 日志级别至 DEBUG 观察 XML 加载过程与变量解析行为。