Dapr .NET SDK 中的错误模型
Dapr .NET SDK 支持 Dapr 运行时实现的更丰富的错误模型。该模型为应用程序提供了一种使用额外上下文来丰富错误的方式， 使应用程序的使用者能够更好地理解问题并更快地解决它。您可以在这里阅读有关更丰富的错误模型的更多信息，并可以在这里找到实现这些错误的 Dapr proto 文件。
Dapr .NET SDK 实现了 Dapr 运行时支持的所有详细信息，在 Dapr.Common.Exceptions 命名空间中实现，并通过
DaprException 扩展方法 TryGetExtendedErrorInfo 访问。目前，此详细信息提取仅支持存在详细信息的
RpcException。
// ExtendedErrorInfo 的使用示例
try
{
// 使用 Dapr 客户端执行某些会抛出 DaprException 的操作。
}
catch (DaprException daprEx)
{
if (daprEx.TryGetExtendedErrorInfo(out DaprExtendedErrorInfo errorInfo))
{
Console.WriteLine(errorInfo.Code);
Console.WriteLine(errorInfo.Message);
foreach (DaprExtendedErrorDetail detail in errorInfo.Details)
{
Console.WriteLine(detail.ErrorType);
switch (detail.ErrorType)
{
case ExtendedErrorType.ErrorInfo:
Console.WriteLine(detail.Reason);
Console.WriteLine(detail.Domain);
break;
default:
Console.WriteLine(detail.TypeUrl);
break;
}
}
}
}
DaprExtendedErrorInfo
包含与错误关联的 Code（状态代码）和 Message（错误消息），从内部的 RpcException 解析而来。
还包含从异常的详细信息中解析的 DaprExtendedErrorDetails 集合。
DaprExtendedErrorDetail
所有详细信息都实现抽象的 DaprExtendedErrorDetail 并具有关联的 DaprExtendedErrorType。
RetryInfo
通知客户端在重试之前应等待多长时间的信息。提供一个带有 Second（秒偏移量）和 Nano（纳秒偏移量）属性的
DaprRetryDelay。
DebugInfo
服务器提供的调试信息。包含 StackEntries（包含堆栈跟踪的字符串集合）和 Detail（进一步的调试信息）。
QuotaFailure
与可能已达到的配额相关的信息，例如 API 的每日使用限制。它有一个属性 Violations，
DaprQuotaFailureViolation 的集合，每个集合包含一个 Subject（请求的主题）和 Description（有关失败的更多信息）。
PreconditionFailure
通知客户端某些必需的前提条件未满足的信息。有一个属性 Violations，DaprPreconditionFailureViolation 的集合，
每个集合具有 Subject（前提条件失败发生的主题，例如 “Azure”）、Type（前提条件类型的表示，例如 “TermsOfService”）和
Description（进一步描述，例如 “ToS must be accepted."）。
RequestInfo
服务器返回的信息，服务器可以使用该信息来标识客户端的请求。包含 RequestId 和 ServingData 属性，
RequestId 是服务器可以解释的某个字符串（例如 UID），ServingData 是构成请求的一部分的任意数据。
LocalizedMessage
包含本地化消息以及消息的区域设置。包含 Locale（区域设置，例如 “en-US”）和 Message（本地化消息）。
BadRequest
描述错误的请求字段。包含 DaprBadRequestDetailFieldViolation 集合，每个集合具有 Field（请求中的错误字段，例如 ‘first_name’）和
Description（详细说明原因的更多信息，例如 “first_name cannot contain special characters”）。
ErrorInfo
详细说明错误的原因。包含三个属性：Reason（错误的原因，应采用 UPPER_SNAKE_CASE 的形式，例如 DAPR_INVALID_KEY）、
Domain（错误所属的域，例如 ‘dapr.io’）和 Metadata，一个包含更多信息的基于键/值的集合。
Help
为客户端提供资源以对问题进行进一步研究。包含 DaprHelpDetailLink 集合，
该集合提供 Url（指向帮助或文档的 url）和 Description（对链接提供的描述）。
ResourceInfo
提供与访问的资源相关的信息。提供三个属性：ResourceType（正在访问的资源的类型，例如 “Azure service bus”）、
ResourceName（资源的名称，例如 “my-configured-service-bus”）、Owner（资源的所有者，例如 “subscriptionowner@dapr.io”）和
Description（与错误相关的资源的更多信息，例如 “missing permissions to use this resource”）。
Unknown
当详细信息类型 url 无法映射到正确的 DaprExtendedErrorDetail 实现时返回。
提供一个属性 TypeUrl（无法解析的类型 url，例如 “type.googleapis.com/Google.rpc.UnrecognizedType”）。