对于最新的稳定版本,请使用 Spring Framework 6.2.10spring-doc.cadn.net.cn

异常

@Controller并且@ControllerAdvice类可以有@ExceptionHandler处理来自控制器方法的异常的方法。以下内容 示例包括这样的处理程序方法:spring-doc.cadn.net.cn

@Controller
public class SimpleController {

	// ...

	@ExceptionHandler (1)
	public ResponseEntity<String> handle(IOException ex) {
		// ...
	}
}
1 声明@ExceptionHandler.
@Controller
class SimpleController {

	// ...

	@ExceptionHandler (1)
	fun handle(ex: IOException): ResponseEntity<String> {
		// ...
	}
}
1 声明@ExceptionHandler.

异常可以与正在传播的顶级异常(即直接IOException被抛出)或针对顶级包装器中的直接原因 异常(例如,一个IOException包裹在一个IllegalStateException).spring-doc.cadn.net.cn

对于匹配的异常类型,最好将目标异常声明为方法参数, 如前面的示例所示。或者,注释声明可以缩小 异常类型。我们通常建议在 参数签名,并在@ControllerAdvice以相应的顺序优先。 有关详细信息,请参阅 MVC 部分spring-doc.cadn.net.cn

@ExceptionHandler方法支持相同的方法参数和 返回值作为@RequestMapping方法,但请求正文除外- 和@ModelAttribute-related 方法参数。

@ExceptionHandlerSpring WebFlux 中的方法由HandlerAdapter@RequestMapping方法。看DispatcherHandler了解更多详情。spring-doc.cadn.net.cn

方法参数

@ExceptionHandler方法支持与@RequestMapping方法,但请求正文可能已经被使用。spring-doc.cadn.net.cn

返回值