Perl客户端连接ejabberd/ecs容器XMPP服务器时认证失败（Nodeprep failed）

什么是Nodeprep错误 #

Nodeprep是XMPP协议中对JID本地部分（即用户名）的标准化处理流程，依据RFC 6122规范，会对用户名做大小写统一、特殊字符过滤、Unicode规范化等操作。出现Nodeprep failed错误，说明客户端发送的用户名不符合XMPP的JID格式要求，或服务器的nodeprep配置存在冲突。

1. 检查客户端用户名格式 #

直接排查Perl代码中使用的用户名：

• 禁止包含空格、@、/、:等特殊字符
• 需为Unicode规范化后的字符串（避免组合字符、不可见符号）
• 长度不能超过1023字节

如果代码中用户名存在上述问题，直接修正即可。

2. 核对ejabberd的nodeprep配置 #

打开ejabberd.yml，检查以下配置：

# 默认正确配置（请勿随意修改）
nodeprep: ejabberd_nodeprep

如果自定义了nodeprep模块或规则，需确认逻辑是否误过滤了合法字符，建议先恢复为默认配置测试。

3. 验证注册用户名与客户端使用的一致性 #

通过ejabberdclt查看已注册用户，确认客户端使用的用户名与注册的完全匹配：

ejabberdclt registered_users your_domain.com

注意排查是否存在全角空格、零宽空格等不可见字符导致的不匹配。

4. 手动标准化Perl客户端的用户名 #

Net::XMPP模块不会自动对用户名做nodeprep处理，可手动添加Unicode规范化逻辑：

use Unicode::Normalize;
# 将用户名转换为Unicode规范化形式C
my $standardized_username = NFC('your_username');

# 后续认证时使用标准化后的用户名
my $auth = $client->AuthSend(
    username => $standardized_username,
    password => 'your_password',
    resource => 'perl_client'
);

5. 开启ejabberd debug日志定位细节 #

在ejabberd.yml中设置日志级别为debug：

loglevel: debug

重启ejabberd后重新发起连接，查看日志中具体的错误提示，比如：

202X-XX-XX XX:XX:XX.XXX [debug] <0.XXX.0>@ejabberd_auth:check_password:XXX Nodeprep failed for username 'invalid_user'

通过日志可直接定位到出问题的用户名。

内容的提问来源于stack exchange，提问作者lukewarms