Asterisk项目中PJSIP联系人配置新增qualify_2xx_only字段解析

在Asterisk 20.12.0-rc1版本中，PJSIP模块引入了一个重要的新配置选项——qualify_2xx_only，这个变更对于使用实时数据库存储PJSIP联系人配置的用户来说需要特别注意。

背景介绍

Asterisk作为一款开源的PBX系统，其PJSIP模块负责处理SIP协议相关功能。在最新发布的20.12.0-rc1版本中，开发团队为PJSIP联系人对象新增了一个名为qualify_2xx_only的配置选项。这个选项主要用于控制联系人的资格认证行为。

问题现象

当用户升级到新版本后，如果使用ODBC实时数据库存储PJSIP联系人配置，系统日志中会出现警告信息，提示"Unknown column 'qualify_2xx_only' in 'field list'"错误。这是因为数据库表中尚未添加这个新字段，而Asterisk已经尝试在SQL查询中使用它。

技术细节

qualify_2xx_only是一个布尔型选项，它决定了在资格认证过程中，系统是否只接受2xx系列的SIP响应作为有效的资格认证响应。当设置为yes时，只有2xx响应会被视为成功；设置为no时，系统会接受任何非失败的响应（包括3xx、4xx等）。

这个选项的引入为管理员提供了更精细的控制能力，特别是在处理某些特殊的SIP设备或中间服务器时，可以更精确地定义什么样的响应应该被视为有效的资格认证响应。

解决方案

对于使用实时数据库存储PJSIP联系人配置的用户，需要进行以下操作：

1. 修改ps_contacts表结构，添加qualify_2xx_only字段
2. 该字段应为布尔类型，建议使用TINYINT(1)或等效类型
3. 默认值可以设置为0（对应no）

对于MySQL数据库，可以使用类似以下的SQL语句：

ALTER TABLE ps_contacts ADD COLUMN qualify_2xx_only TINYINT(1) DEFAULT 0;

升级建议

在升级到Asterisk 20.12.0或更高版本时，管理员应当：

1. 首先检查当前使用的PJSIP存储方式（文件或实时数据库）
2. 如果使用实时数据库，提前准备数据库变更脚本
3. 在升级前或升级后立即执行数据库变更
4. 验证变更是否成功应用

总结

Asterisk 20.12.0版本引入的qualify_2xx_only选项增强了PJSIP模块的联系人资格认证功能。虽然这是一个小改动，但对于依赖实时数据库配置的用户来说，必须相应更新数据库结构才能确保系统正常运行。这种类型的变更也体现了开源软件持续演进的特点，管理员需要关注每个版本的变更日志，以便及时做出相应调整。