YD/T 2937-2015 标准解读

一、核心指标体系梳理

• 本地部分（Localpart）长度上限：255字节（UTF-8编码后）。
• 域名部分（Domainpart）长度上限：1023字节（UTF-8编码后）。
• 资源部分（Resourcepart）长度上限：1023字节（UTF-8编码后）。
• JID整体长度上限：3071字节（UTF-8编码后，含“@”与“/”分隔符）。
• 字符集限定：本地部分仅允许使用RFC 5892定义的PVALID类别Unicode字符；域名部分必须符合IDNA2008标准；资源部分允许任意非控制字符（U+0020–U+10FFFF，排除C0/C1控制字符及U+0000）。
• 大小写处理规则：本地部分区分大小写；域名部分强制小写转换；资源部分区分大小写。
• 保留字符限制：本地部分禁止包含“@”、“/”、“<”、“>”、“&”、“"”、“'”、“”、“:”、“ ”（空格）等字符。

二、关键参数精准释义

1. 本地部分长度：指JID中“@”符号前的字符串经UTF-8编码后的字节数，不包含“@”。测算时需先进行SASLprep（RFC 4013）规范化处理，再计算字节长度。判定依据为YD/T 2937-2015第5.2.1条。
2. 域名部分长度：指“@”之后、“/”之前的主机名或IP地址经UTF-8编码后的字节数。若为国际化域名，须先通过ToASCII转换（RFC 5891），再计算字节长度。判定依据为标准第5.2.2条。
3. 资源部分长度：指“/”之后的字符串经UTF-8编码后的字节数，不含“/”。允许使用resourceprep（RFC 6122附录B）预处理，但非强制。判定依据为标准第5.2.3条。
4. JID整体长度：由本地部分（如存在）、“@”、域名部分、可选“/”及资源部分拼接后，整体UTF-8编码字节数。计算时不得省略任何必需分隔符。判定依据为标准第5.3条。
5. 字符合法性：本地部分字符须通过SASLprep Profile验证；域名部分须通过IDNA2008的Valid/Transitional Processing；资源部分字符须不在Unicode Cc（控制字符）类别内。判定依据分别为标准第6.1、6.2、6.3条。

三、参数合格区间界定

四、参数管控实操建议

• 日常输入校验：在客户端或网关层部署前置校验模块，对用户输入的JID执行UTF-8字节计数、字符合法性扫描及SASLprep/IDNA预处理。校验失败应即时返回错误码XMPP-ERR-JID-MALFORMED。
• 数据统计方法：日志系统应记录原始JID、预处理后JID、各部分字节长度及校验结果。统计周期内按字段分类汇总超限比例、非法字符类型分布、长度分布直方图。
• 偏差修正机制：
  1. 对本地部分超长情形，截断至255字节边界并确保截断点不在UTF-8多字节序列中间；
  2. 对域名部分含大写字母，强制执行toLowerCase()后再进行IDNA转换；
  3. 对资源部分含控制字符，执行resourceprep过滤或拒绝注册；
  4. 整体长度超限时，优先缩减资源部分，其次提示用户缩短本地部分。
• 合规性测试用例：构建覆盖边界值（如255/256字节本地部分）、特殊字符（如U+00A0、U+200B）、混合脚本（如中文+拉丁字母）的测试集，定期执行自动化验证。
• 互操作性保障：与其他XMPP实现交互时，应严格遵循YD/T 2937-2015而非宽松解释，避免因本地策略差异导致路由失败或安全漏洞。