‘功能未实现’响应含义解析及Android向Ejabberd发送自定义IQ咨询

一、“功能未实现”响应到底啥意思？ #

当你给Ejabberd发请求后收到这个提示（对应XMPP标准里的<feature-not-implemented>错误），说白了就是服务器压根不知道怎么处理你的请求，常见原因有这几个：

• 服务器没装处理这个自定义IQ的模块：Ejabberd默认只认标准的XMPP IQ请求，像你用的jabber:iq:conversations这种自定义命名空间的请求，必须在服务器端专门写个扩展模块来对接，不然服务器完全懵圈。
• 请求格式不对：比如你发的是GET类型的IQ，但服务器端的模块只处理SET类型，或者你IQ里的XML结构和服务器预期的不一样，它也会返回这个错误。
• 服务器配置没到位：就算你有对应的模块，要是没在Ejabberd的配置文件里启用它，或者权限设置不让它处理这类请求，照样会给你甩这个错误。

二、你的自定义IQ代码可以这么优化 #

先看你贴的IQCustom类，有几个地方得补全或者调整：

1. 必须写完getIQChildElementXmlStringBuilder方法 #

这个方法是用来生成IQ请求里的XML子元素的，没它你的IQ请求结构就不完整。如果你的自定义IQ不需要额外的内容，最简单的写法是这样：

@Override
protected IQChildElementXmlStringBuilder getIQChildElementXmlStringBuilder(IQChildElementXmlStringBuilder xml) {
    // 直接闭合标签就行，不需要额外内容
    xml.rightAngleBracket();
    return xml;
}

要是你需要传递自定义字段（比如会话ID），可以改成这样：

@Override
protected IQChildElementXmlStringBuilder getIQChildElementXmlStringBuilder(IQChildElementXmlStringBuilder xml) {
    xml.rightAngleBracket();
    // 添加自定义的子元素
    xml.element("conversation-id", "your-conversation-id-here");
    return xml;
}

2. IQ类型的写法更规范点 #

你写的setType(Type.get)其实可以用枚举的大写形式Type.GET，这是XMPP库的规范写法，代码可读性更高：

this.setType(Type.GET);

3. 记得加回调处理响应 #

发送IQ之后，一定要加个回调来处理服务器的回复，不管是成功、错误还是超时都能及时处理。用Smack库的话可以这么写：

// 实例化你的自定义IQ
IQCustom customIQ = new IQCustom("your-user@server.com", "ejabberd-server-domain");
// 获取你的XMPP连接实例
XMPPTCPConnection xmppConnection = ...;

// 发送IQ并设置回调
xmppConnection.sendStanzaWithResponseCallback(customIQ, 
    // 处理成功响应
    stanza -> {
        if (stanza instanceof IQ successIQ && successIQ.getType() == Type.RESULT) {
            // 这里可以解析服务器返回的XML内容，做你需要的逻辑
            System.out.println("收到服务器的成功响应：" + successIQ.toXML());
        }
    },
    // 处理错误情况
    exception -> {
        if (exception instanceof XMPPErrorException errorEx) {
            XMPPError error = errorEx.getXMPPError();
            if (error.getCondition() == XMPPError.Condition.feature_not_implemented) {
                // 这里就是你遇到的"功能未实现"错误，赶紧去检查服务器端的配置和模块吧
                System.err.println("服务器提示功能未实现，请检查服务器模块配置");
            } else {
                // 其他错误类型的处理
                System.err.println("发送IQ失败：" + error.getCondition());
            }
        } else {
            System.err.println("请求超时或连接异常：" + exception.getMessage());
        }
    }
);

4. 服务器端必须配对应模块 #

要让Ejabberd能处理你的自定义IQ，得在服务器的ejabberd.yml配置文件里做两件事：

• 要么自己写一个处理jabber:iq:conversations命名空间的模块，要么找现成的适配模块；
• 在配置里启用这个模块，比如：

modules:
  # 这里的mod_conversations是你自定义模块的名称，要和实际模块名一致
  mod_conversations:
    enabled: true

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