java.lang.IllegalStateException未被ExceptionMapper<Exception>映射的问题排查求助

我来帮你梳理几个最可能的原因，结合你的代码逐一分析：

1. 更具体的异常映射器优先被触发 #

JAX-RS的异常映射器遵循最匹配优先的规则：如果你的应用中存在专门针对IllegalStateException的ExceptionMapper实现，它会比你的通用Exception映射器更早被调用。比如如果有这类代码：

@Provider
class IllegalStateMapper : ExceptionMapper<IllegalStateException> {
    override fun toResponse(e: IllegalStateException): Response {
        // 自定义的IllegalStateException处理逻辑
        return Response.status(Response.Status.BAD_REQUEST).build()
    }
}

那抛出IllegalStateException时，会优先使用这个更具体的映射器，而非你的DefaultExceptionMapper。

2. 映射器的可见性限制导致无法被加载 #

你的DefaultExceptionMapper用了Kotlin的internal修饰符，它的可见性仅限于当前模块。如果JAX-RS运行时（比如Jersey/RESTEasy）所在的模块无法访问这个类，就会导致它无法被注册和使用。解决方法很简单：去掉internal，让类保持默认的public可见性：

@Provider
class DefaultExceptionMapper : ExceptionMapper<Exception> {
    // ... 原有处理逻辑
}

3. Provider未被JAX-RS运行时正确注册 #

虽然你加了@Provider注解，但如果这个类没有被JAX-RS框架扫描到，或者没有手动注册，它根本不会生效：

• 如果用包扫描方式，要确保DefaultExceptionMapper所在的包在JAX-RS的扫描范围内（比如Jersey中@ApplicationPath类上的@Packages注解配置）
• 如果是手动注册，需要在应用配置类里显式注册这个映射器，比如Jersey的ResourceConfig：

class MyApplication : ResourceConfig() {
    init {
        register(DefaultExceptionMapper::class.java)
        // 其他资源或Provider注册逻辑
    }
}

4. 异常被业务代码提前捕获拦截 #

检查你抛出IllegalStateException的代码路径，有没有被try-catch块提前捕获且未重新抛出。比如下面的代码会导致异常无法到达JAX-RS的映射器链：

fun someServiceMethod() {
    try {
        // 触发异常的逻辑
        throw IllegalStateException("Incorrect State")
    } catch (e: IllegalStateException) {
        // 仅打日志但不重新抛出
        logger.error("Error occurred", e)
    }
}

这种情况下，异常被拦截在业务代码内部，根本传不到JAX-RS的异常处理流程中。

排查建议 #

你可以按照这个顺序逐步排查：

• 先去掉internal修饰符，测试是否生效
• 检查应用中是否存在其他针对IllegalStateException的映射器
• 验证DefaultExceptionMapper是否被JAX-RS运行时正确注册
• 追踪异常抛出的代码路径，确认没有被提前捕获

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