Scala中asyncPost异常处理问题：与post方法行为不一致

问题分析 #

Scalatra 同步 post 路由中未捕获的 RuntimeException 会默认返回异常的 toString 结果；但切换到 asyncPost 异步路由后，Future 抛出的异常会触发框架默认的 HTML 错误页面。这是因为异步路由的异常处理逻辑与同步路由不同：同步路由的异常直接由框架基础异常处理器处理，而异步路由中 Future 的异常会被 AsyncSupport 的默认机制捕获并渲染错误页面。

解决方案 #

方案一：手动捕获 Future 异常（局部处理） #

修改业务逻辑代码，在处理 Future 时主动捕获异常，返回与同步路由一致的响应格式：

val response = for {
  myMagic <- doMagic(parsedBody) // Try[Magic] 异常处理正常
  newMagic = moreMagic(myMagic) // Future[MoreMagic] 需手动处理异常
} yield newMagic

response.fold(
  // 处理 Try 失败的情况，保持与原同步逻辑一致
  ex => halt(500, ex.toString),
  // 处理 Future，捕获异常并返回 toString
  future => future
    .map(someMoreMagic)
    .recover { case runtimeEx: RuntimeException =>
      halt(500, runtimeEx.toString)
    }
)

通过 recover 捕获 Future 中的 RuntimeException，调用 halt 设置状态码为 500 并返回异常的字符串表示，和同步路由的行为对齐。

方案二：全局异步异常处理（统一配置） #

如果希望所有异步路由都保持和同步路由一致的异常响应格式，可以在你的 Scalatra Servlet 中重写 handleAsyncException 方法：

override def handleAsyncException(e: Throwable, ctx: scala.concurrent.ExecutionContext): Unit = {
  e match {
    case re: RuntimeException =>
      response.status = 500
      response.body = re.toString
    // 其他类型异常 fallback 到默认处理
    case _ => super.handleAsyncException(e, ctx)
  }
}

这个方法会拦截所有异步路由中未捕获的异常，针对 RuntimeException 直接返回其字符串表示，其他异常仍使用框架默认处理逻辑。

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