Kamailio SIPCapture模块内存损坏问题分析与修复

问题背景

Kamailio是一款开源的SIP服务器，其SIPCapture模块用于捕获和记录SIP通信数据。在5.5.x至5.8.1版本中，用户报告在使用HEP3协议接收SIP数据时，部分伪变量（如$Ri和$si）出现异常值，表现为IP地址截断或错误显示，同时日志格式也出现混乱。

问题现象

用户在使用SIPCapture模块处理HEP3数据时发现：

1. 请求消息中$Ri变量显示不完整（如"217.116.121"缺少最后一个八位组）
2. 回复消息中$Ri变量值与$si相同
3. 日志输出格式混乱（缺少"Reply Code"文本和换行符）

技术分析

通过深入调试和分析，发现问题根源在于ip_addr2a()函数的使用方式。该函数返回一个静态缓冲区地址，而SIPCapture模块直接引用了这个地址而非复制其内容。当后续调用ip_addr2a()时，静态缓冲区被重用，导致之前保存的地址指向的内容被覆盖。

具体表现为：

1. ip_addr2a()返回静态char buff[IP_ADDR_MAX_STR_SIZE]的地址
2. SIPCapture模块直接将返回地址赋值给si->address_str.s
3. 后续日志打印再次调用ip_addr2a()，覆盖了静态缓冲区内容
4. 之前保存的地址现在指向了新的IP字符串

解决方案

Kamailio开发团队迅速响应并修复了此问题，主要修改包括：

1. 确保正确处理IP地址字符串的内存管理
2. 避免直接引用静态缓冲区的地址
3. 修复日志输出格式问题

影响范围

该问题影响Kamailio 5.5.x至5.8.1版本，已在master分支中修复，并计划包含在即将发布的5.8.2版本中。

临时解决方案

在等待正式版本发布期间，用户可以考虑：

1. 使用5.4.x或更早版本
2. 使用nonsip_hook=1配置并自行处理SIP消息
3. 使用sipdump模块的事件回调作为替代方案

技术启示

此案例提醒开发者在使用返回静态缓冲区的函数时需要特别注意：

1. 静态缓冲区的生命周期和重用特性
2. 必要时应该复制内容而非直接引用地址
3. 在多线程环境中更需谨慎处理此类情况

Kamailio团队对此问题的快速响应和修复展现了开源社区的高效协作，确保了SIP通信监控功能的可靠性。