Spring Boot嵌入Camunda 7自定义ExceptionMapper打Fat Jar报错求助

核心问题根源 #

Spring Boot打包的Fat Jar采用嵌套Jar结构，而Jersey默认的JarZipSchemeResourceFinderFactory无法正确解析jar:jar:file:...这类嵌套URL，导致启动时找不到嵌入Jar中的自定义ExtendedRestExceptionHandler类，抛出FileNotFoundException。

可行解决方案 #

方案1：显式注册自定义ExceptionMapper（推荐） #

绕过Jersey的自动类扫描逻辑，直接手动注册自定义异常处理器，彻底避免嵌套Jar扫描问题：

import org.camunda.bpm.engine.rest.impl.JerseyResourceConfig;
import org.springframework.stereotype.Component;

@Component
public class CustomCamundaJerseyConfig extends JerseyResourceConfig {
    @Override
    public void init() {
        super.init();
        // 直接注册你的自定义异常处理器类
        registerClasses(ExtendedRestExceptionHandler.class);
    }
}

方案2：替换Jersey扫描器为Spring实现 #

利用Spring本身对嵌套Jar的支持能力，替换Jersey默认的资源扫描器：

import org.glassfish.jersey.server.ResourceConfig;
import org.glassfish.jersey.server.spring.scanning.SpringComponentProvider;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        // 注册Spring组件扫描器，处理嵌套Jar路径
        register(new SpringComponentProvider());
        // 指定自定义ExceptionMapper所在的包路径
        packages("com.your.package.exception.handler");
    }
}

方案3：调整Fat Jar打包配置，解压嵌套Jar #

通过打包插件配置，将自定义类所在的Jar解压到Fat Jar的平级结构中，让Jersey默认扫描器能正常识别：

Maven配置示例

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <requiresUnpack>
            <!-- 指定需要解压的自定义类所在Jar -->
            <dependency>
                <groupId>com.your.group</groupId>
                <artifactId>your-custom-artifact</artifactId>
            </dependency>
        </requiresUnpack>
    </configuration>
</plugin>

注意事项 #

• 优先选择方案1，显式注册逻辑最稳定，无额外依赖或打包体积问题
• 方案2需确保Spring Boot与Jersey版本兼容（Spring Boot 2.7.10对应Jersey 2.35，无兼容问题）
• 方案3会增大Fat Jar体积，且可能引发类加载顺序问题，仅作为临时替代方案使用

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