SpringBoot项目中如何从Jar包加载Jersey端点？

针对你遇到的外部Tomcat部署WAR包后，WEB-INF/lib中Jar包的Jersey端点无法访问的问题，可按以下步骤排查解决：

1. 修正Jersey包扫描路径 #

你的packages("com.example.core.oauth.*")写法错误，Jersey的packages方法不需要添加*，递归扫描包下所有类是默认行为，改为：

packages("com.example.core.oauth");

多余的通配符会导致Jersey无法正确识别目标包路径，进而扫描不到Jar中的资源类。

2. 验证Jar包中资源类的JAX-RS规范 #

确保Jar包内的端点类满足：

• 类为public访问权限
• 类上标注了@Path注解
• 方法上标注了@GET/@POST等请求方法注解
• 没有遗漏必要的JAX-RS依赖（项目内端点正常则依赖无问题）

3. 检查Gradle WAR打包配置 #

确认build.gradle中正确配置WAR插件及依赖：

plugins {
    id 'org.springframework.boot' version '对应版本号'
    id 'war'
}

// 生成指定名称的WAR包
war {
    archiveFileName = '你的应用名称.war'
}

dependencies {
    // 引入目标Jar包依赖
    implementation '你的Jar包groupId:artifactId:版本号'
    
    // 外部Tomcat部署需排除内置Tomcat
    providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat'
    
    // 其他Spring Boot、Jersey依赖...
}

执行gradle war后，检查生成的WAR包中WEB-INF/lib目录是否包含你的目标Jar包。

4. 开启Jersey扫描日志排查 #

在application.properties中添加日志配置，查看Jersey实际扫描到的类：

logging.level.org.glassfish.jersey=DEBUG
logging.level.org.glassfish.jersey.server.scanning=TRACE

启动Tomcat后，查看日志中是否出现Jar包内com.example.core.oauth下的资源类信息。如果日志中没有相关类，说明扫描路径仍有问题；如果有但还是404，检查@Path注解的路径是否正确。

5. 手动注册Jar包中的资源类 #

如果自动扫描仍无效，尝试手动注册Jar内的端点类，验证是否为扫描机制问题：

public JerseyConfig(){
    packages("com.example.core.oauth");
    property(ServletProperties.FILTER_FORWARD_ON_404, true);
    register(OauthController.class);
    // 手动注册Jar中的具体资源类
    register(com.example.core.oauth.OauthResource.class);
    // 如有多个类，依次注册
}

如果手动注册后能正常访问，说明自动扫描的配置仍有问题，可继续排查扫描路径或Jersey版本兼容问题。

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