OpenFire插件自定义REST API调用出现404错误求助

阿华AIGC实验室

2026-5-15

排查OpenFire自定义REST API 404错误的解决方案

让我们一步步拆解你遇到的404问题，从路径映射、配置结构到资源注册，逐个排查核心问题：

1. URL路径叠加冲突（最可能的原因）

你当前的配置存在路径叠加问题：

web-custom.xml中Servlet映射的是/de/*
控制器ContactManagementController的@Path又设置了restapi/v1/de/temp

这会导致实际的访问路径变成：[插件上下文路径]/de/restapi/v1/de/temp，和你调用的http://localhost/plugins/restapi/v1/de/temp完全不匹配。

另外要注意：OpenFire插件的Web资源默认挂载在/plugins/[你的插件名]/路径下（比如你的插件jar叫contact-management-plugin.jar，基础路径就是http://localhost:9090/plugins/contact-management-plugin/，默认OpenFire HTTP端口是9090，如果你改了端口要对应调整）。

修正方案

调整Servlet映射和控制器路径，避免叠加：

修改web-custom.xml的Servlet映射：

<servlet-mapping>
    <servlet-name>JerseyWrapper</servlet-name>
    <url-pattern>/restapi/*</url-pattern>
</servlet-mapping>

修改控制器的@Path：

@Path("v1/de/temp") 
public class ContactManagementController { 
    // 原有代码不变
}

此时正确的访问URL应为：http://localhost:9090/plugins/[你的插件名]/restapi/v1/de/temp

2. 检查插件结构与配置文件位置

OpenFire插件对文件结构有严格要求，确保你的jar包结构如下：

your-plugin.jar
├── plugin.xml       # 插件核心配置文件，必须存在
└── WEB-INF
    ├── web-custom.xml  # 你的Servlet配置文件，必须在WEB-INF下
    └── classes
        └── plugin
            ├── JerseyWrapper.class
            └── ContactManagementController.class

如果web-custom.xml不在WEB-INF目录下，OpenFire不会加载你的Servlet配置。

3. 验证Jersey资源注册的正确性

看你的JerseyWrapper代码，手动添加了ContactManagementController.class到资源配置中，但要注意：

确认ContactManagementController和JerseyWrapper的包路径是否匹配？如果控制器在子包（比如plugin.controller），PackagesResourceConfig(JerseyWrapper.class.getPackage().getName())只会扫描plugin包，不会自动扫子包（不过你手动add了类，这部分问题不大）。
检查Jersey版本兼容性：OpenFire 4.x系列默认使用Jersey 1.x，你代码里用的com.sun.jersey包是正确的，但要确保插件jar里没有打包冲突的依赖（比如不要把OpenFire已有的Jersey类打包进去，避免类加载异常）。