学习Web应用开发中的异常处理_web项目加入异常处理-CSDN博客

本文链接：https://blog.csdn.net/mikxx/article/details/135215107

介绍

在本篇博客中，我们将深入学习如何在Web应用开发中进行异常处理，并通过代码示例演示常见的异常处理实践。

异常处理的重要性

异常处理在Web应用开发中具有重要的作用，以下是异常处理的几个重要方面：

提高应用的可靠性和稳定性：良好的异常处理实践可以帮助应用在出现异常情况时保持稳定运行。通过捕获和处理异常，可以防止应用因为未处理的异常而崩溃或无法继续执行。
增强用户体验：当应用遇到异常情况时，及时、准确地向用户提供有意义的错误信息，可以帮助用户更好地理解问题所在，并提供相应的解决方案。这样可以提高用户满意度，增强用户对应用的信任感。
便于排查和修复问题：异常处理可以记录异常发生的详细信息，包括异常类型、发生位置、相关数据等，这些信息对于后续问题的排查和修复非常有价值。通过查看异常日志，开发人员可以快速定位问题，并采取相应的措施进行修复。
安全性考虑：合理处理异常可以提高应用的安全性。例如，在处理用户输入时，如果发现输入数据存在安全风险（如SQL注入、跨站脚本攻击等），及时抛出异常并进行相应的处理，可以有效防止安全漏洞的利用。

常见的Web应用异常类型

在Web应用开发中，常见的异常类型包括：

输入校验异常：当用户输入的数据不符合规定的格式或范围时，抛出输入校验异常。例如，用户未填写必填字段、输入的邮件地址格式不正确等。
业务逻辑异常：当应用的业务逻辑条件不满足时，抛出业务逻辑异常。例如，用户购买商品时库存不足、用户已存在等。
数据访问异常：当访问数据库或其他数据存储服务时出现错误时，抛出数据访问异常。例如，数据库连接失败、查询结果为空等。
系统异常：当系统发生无法预料的错误或故障时，抛出系统异常。例如，内存溢出、文件读写错误等。

统一异常处理器

使用@ControllerAdvice注解创建全局异常处理器，它能够捕获应用中抛出的异常，并提供统一的处理方式。

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception ex) {
        ErrorResponse errorResponse = new ErrorResponse();
        errorResponse.setMessage("An error occurred");
        // 设置其他错误信息，如错误码等

        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

上述代码中，GlobalExceptionHandler类使用@ExceptionHandler注解来处理Exception类型的异常。在捕获到异常后，我们创建了一个ErrorResponse对象来封装错误信息，然后通过ResponseEntity返回给客户端。在处理方法中，你可以根据具体的业务需求，编写逻辑来处理异常。你可以返回自定义的错误信息，选择合适的HTTP状态码，甚至可以记录日志或发送通知等。需要注意的是，全局异常处理器只能处理由Controller层抛出的异常。如果你想要处理其他层抛出的异常，可以使用其他方式，例如@RestControllerAdvice或者自定义的AOP拦截器等。

自定义异常类

在应用中，我们可以自定义异常类来抛出和捕获特定类型的异常，并提供有意义的错误信息。

public class CustomException extends RuntimeException {

    public CustomException(String message) {
        super(message);
    }
}

自定义异常类CustomException继承自RuntimeException，可以根据业务需求添加其他字段或方法。下面的代码展示了如何在应用中抛出和捕获自定义异常。

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        User user = userService.getUserById(id);
        if (user == null) {
            throw new CustomException("User not found");
        }
        return user;
    }

    @ExceptionHandler(CustomException.class)
    public ResponseEntity<ErrorResponse> handleCustomException(CustomException ex) {
        ErrorResponse errorResponse = new ErrorResponse();
        errorResponse.setMessage(ex.getMessage());
        // 设置其他错误信息，如错误码等

        return new ResponseEntity<>(errorResponse, HttpStatus.NOT_FOUND);
    }
}

在上述代码中，UserController类中的getUser方法通过调用userService获取用户信息，如果用户不存在，则抛出CustomException异常。在同一个类中，我们使用@ExceptionHandler注解处理CustomException类型的异常，并返回自定义的错误信息。

异常日志记录

在应用中，记录异常日志是非常重要的，便于后续问题的排查和分析。可以使用日志框架（如Logback、Log4j2）记录异常信息。

@ControllerAdvice
public class GlobalExceptionHandler {

    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception ex) {
        logger.error("An error occurred", ex);

        ErrorResponse errorResponse = new ErrorResponse();
        errorResponse.setMessage("An error occurred");
        // 设置其他错误信息，如错误码等

        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

在上述代码中，我们通过LoggerFactory获取到一个日志记录器，然后使用logger.error方法记录异常信息。

测试异常处理

编写测试用例，模拟应用中的异常情况，并验证全局异常处理器和自定义异常处理方法的正确性和稳定性。

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void testHandleCustomException() throws Exception {
        mockMvc.perform(get("/users/999"))
                .andExpect(status().isNotFound())
                .andExpect(jsonPath("$.message").value("User not found"));
    }
}

在上述代码中，我们使用MockMvc来模拟HTTP请求，并通过断言验证返回的HTTP状态码和JSON响应中的错误信息。