建模异常和处理服务器应用程序中的 http 代码

Question

我正在开发一个 spring 启动应用程序，它使 http 调用多个外部服务，聚合并将响应返回到前端。

这是我项目的当前结构：

RouteController -> Handler -> ServiceLayer

• RouteController 路由到不同的处理程序
• Handler 调用多个服务，执行聚合并返回响应。
• 每个服务调用都有不同的 ServiceLayers。
• 处理程序可以返回部分响应，如果一个服务调用失败，它将返回其他调用的响应。
• 我没有添加类/控制器级别的异常处理程序，因为也可以返回部分响应。

注意- 此应用程序将始终发送 Http 200 响应，除非所有服务调用都失败。
Spring异常处理我在这里寻找的是应用程序内部的异常处理。

我正在尝试在此服务中添加异常处理，并且似乎没有明确简洁的规则。

这是我为任何依赖失败创建的自定义异常 -

class DependencyException : RuntimeException {
    constructor() : super()
    constructor(message: String?) : super(message)
    constructor(cause: Exception?) : super(cause)
    constructor(message: String?, cause: Exception?) : super(message, cause)
}

这是调用 UserService 的服务层中的代码 -

fun getUsers(): List<User>? {
        logger.info { "entered: getUsers " }
        val response = userControllerApiClient.getUsers()

        when (response.statusCode.is2xxSuccessful) {
            true -> return response.body?.users
            false ->  throw DependencyException()
        }
    }

已使用org.springframework.http库进行 http 调用。

有几个问题我找不到明确的答案——

• 服务何时应该编写自己的异常？
• 何时使用 kotlin/java 标准库现有异常？
• 您是否应该将 spring http 异常传播到处理程序/控制器层？
• 上面的依赖异常的scope是不是太大了？
• 4xx,5xx 错误代码是否应该转换为不同的自定义异常以进行内部处理？ （以及每个系列中不同代码的不同处理？）
• 您建议在此项目中处理异常的最佳方法是什么？

Answer 1

您好，您的问题：

1. 服务何时应该编写自己的异常？ -->

这取决于您的业务逻辑，例如您有一个服务层来更新用户，您应该通过 ID 找到它，如果找不到用户，您应该抛出异常

2. 何时使用 kotlin/java 标准库现有异常？

如果您使用 spring-boot 是一个框架，为您提供现成的库和 APIS 来处理所有您可以查看此链接https://www.baeldung.com/exception-handling-for-rest-with-spring

3. 您是否应该将 spring Http 异常传播到处理程序/控制器层？

是的; 因为controller负责处理Http的异常，业务层的service

4. 上面的依赖异常的scope是不是太大了？

我没看懂这个问题

5. 4xx,5xx 错误代码是否应该转换为不同的自定义异常类型？ （以及每个系列中不同代码的不同处理？）

不需要，建议返回 Http 错误代码和自定义消息，以便客户端了解异常错误原因

6. 您建议在此项目中处理异常的最佳方法是什么？

我推荐遵循 jhiptser spring 引导项目结构， https://www.jhipster.tech/managing-server-errors/

Answer 2

1. 服务何时应该编写自己的异常？ 每当标准库中的现有异常不涵盖您的用例时，或者当您想在异常中添加更多详细信息时。

2. 何时使用 kotlin/java 标准库现有异常？ 同上，不要试图重新发明轮子。 比如，使用 IllegalArgumentException 而不是创建您自己的 InvalidRequestException。 看看这里 - https://programming.guide/java/list-of-java-exceptions.html

3. 您是否应该将 spring Http 异常传播到处理程序/控制器层？ 我建议不要将任何外部框架的异常传播到您的 controller。 相反，编写您自己的异常，并尽可能多地使用 Java.lang 中的现有异常。 Http 异常应该保留在它们的预期位置，即请求/响应层。
4. 上面的依赖异常的scope是不是太大了？ 这里的依赖异常太宽泛了，如果您的应用程序必须以不同的方式处理不同的 Http 代码怎么办。 您将如何处理该问题？
5. 4xx,5xx 错误代码是否应该转换为不同的自定义异常类型？ （以及每个系列中不同代码的不同处理方式？）很大程度上取决于客户的需求。 正如您所提到的，在您的情况下，您正在编排层处理它们并抑制它们。 您是否认为这种实现在未来会发生变化，以及变化多远？ 我建议的第一步是至少 map 4xx 和 5xx 错误到不同的异常。 仔细看看，看看你想重试/恢复哪些，并从中派生另一种类型。

这里有一些资源我认为你应该看看 -

https://itnext.io/graceful-error-handling-in-rest-driven-web-applications-d4209b4937aa

https://github.com/cloudendpoints/endpoints-java/blob/master/endpoints-framework/src/main/java/com/google/api/server/spi/ServiceException.java

REST API 错误返回良好做法