使用ASP.NET Core 3.x 构建 RESTful API - 3.3.3 ProblemDetails
當ASP.NET Core?大約在?2.1?版本的時候,它引入了?ProblemDetails。ProblemDetails是基于?RFC7807?這個規范,目的是讓?HTTP?響應可以攜帶錯誤的詳細信息,而不是只返回一個錯誤的狀態碼。?
在?ASP.NET Core 2.2的時候,如果Controller使用了?[ApiController]?這個屬性,那么?ProblemDetails?就是客戶端錯誤碼的標準響應。?
例如,當返回類型為?IActionResult?的方法返回客戶端錯誤狀態碼的時候(4xx),同時還會返回一個body,這個?body?就是?ProblemDetails。?這個結果里還會包含著一個相關的ID,使用這個ID,就可以把錯誤和相應的請求日志關聯起來。?
?
關于ProblemDetails這個類,可以查看:官方文檔。?
?
為了使用ProblemDetails??
需要為應用程序定義一個通用的錯誤顯示格式;?
很多時候,只返回HTTP狀態碼并不能表達和傳遞出足夠的信息。?
?
在ASP.NET Core 3.x里面,同樣也使用了?ProblemDetails。?
看一個返回404的例子:?
這是一個Get請求,但是并沒有找到該資源,返回的狀態碼是404,而響應的body就是?ProblemDetails。?
值得注意的是,這個響應的?Content-Type?是?application/problem+json:?
總結
以上是生活随笔為你收集整理的使用ASP.NET Core 3.x 构建 RESTful API - 3.3.3 ProblemDetails的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 你知道怎么使用DebugView查看调试
- 下一篇: 使用ASP.NET Core 3.x 构