添加自定义Exception Mapper遇报错：已映射异常处理响应时出错

我之前在Dropwizard项目里踩过一模一样的坑！这个报错 Error occurred when processing a response created from an already mapped exception 本质是Jersey的异常处理机制混乱了，通常是下面几个原因导致的，给你逐个拆解解决方案：

1. 异常被多个Mapper重复处理 #

最常见的情况是：你自定义的Mapper和Dropwizard/Jersey内置的Mapper（比如WebApplicationExceptionMapper）同时匹配到了同一个异常类型，导致Jersey尝试二次处理已经被处理过的异常。

解决办法：给你的Mapper设置更高优先级
用@Priority注解让你的Mapper先被执行，优先级数值越小，执行顺序越靠前（默认优先级是5000）：

@Provider
@Priority(1) // 优先级高于默认的内置Mapper
class MyCustomExceptionMapper : ExceptionMapper<MyCustomException> {
    override fun toResponse(exception: MyCustomException): Response {
        return Response.status(Response.Status.BAD_REQUEST)
            .entity(mapOf("error_code" to exception.errorCode, "message" to exception.message))
            .type(MediaType.APPLICATION_JSON_TYPE)
            .build()
    }
}

另外还要注意：不要重复注册Mapper——既不要同时用@Provider让框架自动扫描，又手动在environment.jersey().register()里再注册一遍。

2. Mapper内部抛出未捕获的异常 #

如果你的toResponse方法里的处理逻辑出了问题（比如序列化错误、空指针、资源加载失败），Jersey会认为当前Mapper处理失败，转而尝试用其他Mapper处理原异常，但此时原异常已经被标记为"已映射"，就会触发这个报错。

解决办法：给Mapper的处理逻辑加兜底捕获
确保toResponse方法不会向外抛出任何异常，用try-catch包裹核心逻辑：

override fun toResponse(exception: MyCustomException): Response {
    return try {
        // 你的正常响应构建逻辑
        val errorBody = ObjectMapper().writeValueAsString(mapOf("error" to exception.message))
        Response.status(Response.Status.BAD_REQUEST)
            .entity(errorBody)
            .type(MediaType.APPLICATION_JSON_TYPE)
            .build()
    } catch (e: Exception) {
        // 兜底返回一个简单的错误响应，避免触发二次异常处理
        Response.status(Response.Status.INTERNAL_SERVER_ERROR)
            .entity(mapOf("error" to "Failed to generate error response"))
            .type(MediaType.APPLICATION_JSON_TYPE)
            .build()
    }
}

3. 异常类型的继承关系冲突 #

如果你的自定义Exception继承了某个已经被内置Mapper处理的异常（比如WebApplicationException），那么内置Mapper和你的自定义Mapper都会匹配这个异常，引发冲突。

解决办法二选一：

• 调整自定义Exception的继承结构，避免继承WebApplicationException这类被内置Mapper覆盖的异常；
• 保持继承关系，但通过@Priority让你的Mapper优先级远高于内置Mapper（比如设置为@Priority(1)）。

4. 彻底接管异常处理（谨慎操作） #

如果你想完全替代Dropwizard的默认异常处理逻辑，可以关闭所有内置Mapper，只保留你自己的：

override fun run(configuration: MyAppConfig, environment: Environment) {
    // 关闭Jersey默认的异常Mapper
    environment.jersey().getResourceConfig().properties["jersey.config.server.disableMappers"] = true
    
    // 注册你自己的所有自定义Mapper
    environment.jersey().register(MyCustomExceptionMapper::class.java)
    environment.jersey().register(GlobalExceptionMapper::class.java)
}

⚠️ 注意：这个操作会让你需要处理所有类型的异常（包括Jersey自身的请求解析异常、空指针等），所以一定要确保你的全局Mapper能覆盖所有场景。

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