Kamailio项目中SMSOPS模块内存泄漏问题分析与解决

问题背景

在Kamailio 5.8.1版本（运行于Ubuntu 22.04 Jammy 64位系统）中，当处理3GPP IMS SMS消息时，系统出现了严重的内存泄漏问题。具体表现为：在500条消息/秒的负载下运行20分钟后，可用内存从80%急剧下降到25%，最终导致系统无法继续处理流量。

问题现象

系统日志中频繁出现以下关键错误信息：

1. 内存分配失败错误：qm_find_free(): Free fragment not found!
2. SMSOPS模块解码错误：decode_3gpp_sms(): Error allocating 192 bytes!
3. 私有内存池耗尽：could not allocate private memory from pkg pool

监控数据显示，UDP接收进程的PKG内存使用量逐渐增加直至耗尽，所有子进程最终都会出现相同问题。

技术分析

内存管理机制

Kamailio使用两种主要内存池：

• 共享内存(SHM)：用于跨进程共享数据
• 私有内存(PKG)：每个进程独立的内存池

在默认配置下（512MB SHM和256MB PKG），系统在高负载下表现出内存泄漏特征。

SMSOPS模块问题根源

通过代码审查发现，问题源于SMSOPS模块中RP_DATA处理逻辑的变更。原始代码会复用已分配的rp_data指针，而修改后的版本在每次处理消息时都会重新分配内存，但未在所有错误路径上正确释放内存。

关键代码变更对比：

// 原始代码（正确）
if (!rp_data) {
    rp_data = pkg_malloc(sizeof(struct _sms_rp_data));
} else {
    freeRP_DATA(rp_data);
}

// 修改后代码（有问题）
if(rp_data) {
    freeRP_DATA(rp_data);
}
rp_data = pkg_malloc(sizeof(struct _sms_rp_data));

内存泄漏连锁反应

初始的SMSOPS模块内存泄漏会导致：

1. UDP接收进程的PKG内存逐渐耗尽
2. 影响核心消息处理功能
3. 最终导致系统无法分配任何新内存

解决方案

临时解决方案

1. 调整内存配置：

   • 减少PKG内存至16-32MB
   • 增加SHM内存至1GB
   • 虽然不能根本解决问题，但可以延缓内存耗尽时间

2. 代码回退：

   • 恢复原始的内存管理逻辑
   • 确保在所有错误路径上正确释放内存

长期解决方案

1. 应用官方修复补丁：

   • 使用已提交的修复commit，正确处理内存分配和释放
   • 确保在所有代码路径上都有正确的资源清理

2. 内存使用监控：

   • 实现内存使用监控机制
   • 在内存使用达到阈值时触发告警或自动重启

最佳实践建议

1. 生产环境部署建议：

   • 使用最新稳定版本Kamailio
   • 在升级前进行全面测试
   • 监控系统内存使用情况

2. 性能调优建议：

   • 根据实际负载调整子进程数量
   • 合理配置SHM和PKG内存比例
   • 定期检查内存碎片情况

3. 开发规范建议：

   • 模块开发中严格遵循内存管理规范
   • 为所有资源分配实现对应的释放路径
   • 进行充分的内存泄漏测试

总结

Kamailio的SMSOPS模块内存泄漏问题展示了在SIP服务器开发中内存管理的重要性。通过深入分析错误日志和代码变更，我们不仅找到了问题根源，也提出了有效的解决方案。这类问题的解决不仅需要技术层面的修复，更需要建立完善的开发、测试和监控流程，以确保系统的长期稳定运行。