Baresip项目中关于Attended Transfer中Replaces头域缺失标签问题的分析与修复

在SIP协议中，Attended Transfer（人工转接）是一种常见的呼叫控制功能，它允许用户将一个已建立的呼叫转接到另一个目标。在实现这一功能时，RFC 3891规范要求Replaces头域必须包含完整的对话标识信息，包括call-id、to-tag和from-tag。然而，在Baresip项目的当前实现中发现了一个技术问题。

问题背景

Baresip项目中的call_replace_transfer函数负责生成Attended Transfer所需的REFER请求。在实现过程中，开发者发现生成的Replaces头域只包含了call-id信息，而缺少了to-tag和from-tag这两个关键参数。这种实现不符合RFC 3891规范的要求，导致与某些电话系统（如Asterisk）的兼容性问题。

技术分析

根据RFC 3891规范，Replaces头域必须完整标识一个SIP对话，其格式应为：

Replaces: call-id;to-tag=xxx;from-tag=yyy

在Baresip的原始实现中，call_replace_transfer函数生成的Refer-To头域仅包含call-id部分：

Refer-To: <target_uri?Replaces=call-id>

这种不完整的实现会导致目标系统无法正确识别被替换的对话，特别是在分布式环境中，仅凭call-id无法唯一标识一个SIP对话。

解决方案

为解决这一问题，开发者提出了以下修改方案：

1. 在re库的sip/dialog.c中新增了两个API函数，用于获取对话的本地和远程标签：

const char *sip_dialog_ltag(const struct sip_dialog *dlg);
const char *sip_dialog_rtag(const struct sip_dialog *dlg);

2. 修改call_replace_transfer函数，在生成Refer-To头域时包含完整的对话标识信息：

"Refer-To: <%s?Replaces=%s%%3Bto-tag%%3D%s%%3Bfrom-tag%%3D%s>"

3. 对参数进行URL编码处理（使用%3B代替分号，%3D代替等号），确保特殊字符的正确传输。

实现意义

这一修复具有以下重要意义：

1. 规范兼容性：使Baresip的Attended Transfer实现完全符合RFC 3891规范要求。

2. 系统兼容性：解决了与Asterisk等电话系统的互操作问题，这些系统严格依赖完整的对话标识来识别被替换的呼叫。

3. 功能完整性：确保了在复杂网络环境下，呼叫转接功能能够可靠工作，特别是在涉及多个中间服务器的场景中。

技术细节

在SIP协议中，一个完整的对话标识需要三个要素：

• Call-ID：呼叫的唯一标识
• To-Tag：被叫方生成的标签
• From-Tag：主叫方生成的标签

这三个要素共同构成了对话的唯一标识符。缺少任何一个都会导致对话识别失败，特别是在存在多个分支或并行呼叫的情况下。

总结

通过对Baresip项目中Attended Transfer实现的这一改进，不仅解决了与特定系统的兼容性问题，更重要的是提升了整个项目对SIP标准的遵从性。这种对细节的关注体现了开源项目持续改进的精神，也为其他SIP开发者提供了正确处理Replaces头域的参考范例。

对于使用Baresip进行呼叫控制开发的工程师来说，理解这一修改的技术背景和实现细节，有助于在遇到类似问题时快速定位和解决，同时也提醒我们在实现SIP功能时要严格遵循相关RFC规范。