This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Dapr Jobs .NET SDK

通过 Dapr Jobs 和 Dapr .NET SDK 快速上手

使用 Dapr Job 包，您可以在 .NET 应用程序中与 Dapr Job API 交互，按照预定义的计划触发未来操作运行，并支持可选的有效负载。

要开始使用，请阅读 Dapr Jobs 操作指南，并参考最佳实践文档获取更多指导。

1 - 操作指南：在 .NET SDK 中编写和管理 Dapr Jobs

了解如何使用 .NET SDK 编写和管理 Dapr Jobs

让我们创建一个在 Dapr Jobs 触发时会被调用的端点，然后在同一应用中调度该任务。我们将使用此处提供的简单示例进行以下演示，并以此作为说明，介绍如何使用间隔时间或 Cron 表达式来调度一次性或重复任务。在本指南中，你将：

  • 部署一个 .NET Web API 应用程序 (JobsSample)
  • 使用 Dapr .NET Jobs SDK 来调度任务调用并设置要触发的端点

在 .NET 示例项目中：

  • 主要的 Program.cs 文件包含了本演示的全部内容。

前置条件

设置环境

克隆 .NET SDK 仓库。

git clone https://github.com/dapr/dotnet-sdk.git

从 .NET SDK 根目录导航到 Dapr Jobs 示例。

cd examples/Jobs

在本地运行应用程序

要运行 Dapr 应用程序，你需要启动 .NET 程序和 Dapr 边车。导航到 JobsSample 目录。

cd JobsSample

我们将运行一个同时启动 Dapr 边车和 .NET 程序的命令。

dapr run --app-id jobsapp --dapr-grpc-port 4001 --dapr-http-port 3500 -- dotnet run

Dapr 在 http://localhost:3500 监听 HTTP 请求，在 http://localhost:4001 监听内部 Jobs gRPC 请求。

使用依赖注入注册 Dapr Jobs 客户端

Dapr Jobs SDK 提供了一个扩展方法来简化 Dapr Jobs 客户端的注册。在 Program.cs 中完成依赖注入注册之前，添加以下行：

var builder = WebApplication.CreateBuilder(args);

//Add anywhere between these two lines
builder.Services.AddDaprJobsClient();

var app = builder.Build();

请注意，在 Jobs API 的当前实现中，调度任务的应用也将是接收触发通知的应用。换句话说，你无法调度一个在另一个应用中运行的触发器。因此，虽然你不需要显式地在应用中注册 Dapr Jobs 客户端来调度触发器调用端点，但如果没有同一应用以某种方式调度任务（无论是通过此 Dapr Jobs .NET SDK 还是通过对边车的 HTTP 调用），你的端点永远不会被调用。

你可能希望为 Dapr Jobs 客户端提供一些配置选项，这些选项应在每次对边车的调用时都存在，例如 Dapr API 令牌，或者你想使用非标准的 HTTP 或 gRPC 端点。这可以通过使用注册方法的重载来实现，该重载允许配置 DaprJobsClientBuilder 实例：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient((_, daprJobsClientBuilder) =>
{
    daprJobsClientBuilder.UseDaprApiToken("abc123");
    daprJobsClientBuilder.UseHttpEndpoint("http://localhost:8512"); //非标准的边车 HTTP 端点
});

var app = builder.Build();

不过，你希望注入的任何值可能需要从其他来源获取，这些来源本身已注册为依赖。还有一个重载可以使用，它可以将 IServiceProvider 注入到配置操作方法中。在以下示例中，我们注册了一个虚构的单例，该单例可以从某个地方获取密钥，并将其传递给 AddDaprJobClient 的配置方法，这样我们就可以从其他地方检索 Dapr API 令牌以在此处进行注册：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSingleton<SecretRetriever>();
builder.Services.AddDaprJobsClient((serviceProvider, daprJobsClientBuilder) =>
{
    var secretRetriever = serviceProvider.GetRequiredService<SecretRetriever>();
    var daprApiToken = secretRetriever.GetSecret("DaprApiToken").Value;
    daprJobsClientBuilder.UseDaprApiToken(daprApiToken);

    daprJobsClientBuilder.UseHttpEndpoint("http://localhost:8512");
});

var app = builder.Build();

使用 IConfiguration 配置 Dapr Jobs 客户端

也可以使用已注册的 IConfiguration 中的值来配置 Dapr Jobs 客户端，而无需像上一节演示的那样使用 DaprJobsClientBuilder 显式指定每个值覆盖。相反，通过填充通过依赖注入提供的 IConfiguration，AddDaprJobsClient() 注册将自动使用这些值而不是各自的默认值。

首先，在配置中填充值。这可以通过几种不同的方式来完成，如下所示。

通过 ConfigurationBuilder 进行配置

可以在不使用配置源的情况下配置应用程序设置，而是通过使用 ConfigurationBuilder 实例在内存中填充值：

var builder = WebApplication.CreateBuilder();

//Create the configuration
var configuration = new ConfigurationBuilder()
    .AddInMemoryCollection(new Dictionary<string, string> {
            { "DAPR_HTTP_ENDPOINT", "http://localhost:54321" },
            { "DAPR_API_TOKEN", "abc123" }
        })
    .Build();

builder.Configuration.AddConfiguration(configuration);
builder.Services.AddDaprJobsClient(); //这将自动从 IConfiguration 填充 HTTP 端点和 API 令牌值

通过环境变量进行配置

可以从应用程序可用的环境变量中访问应用程序设置。

以下环境变量将用于填充注册 Dapr Jobs 客户端时使用的 HTTP 端点和 API 令牌。

键值
DAPR_HTTP_ENDPOINThttp://localhost:54321
DAPR_API_TOKENabc123
var builder = WebApplication.CreateBuilder();

builder.Configuration.AddEnvironmentVariables();
builder.Services.AddDaprJobsClient();

Dapr Jobs 客户端将被配置为使用 HTTP 端点 http://localhost:54321，并在所有出站请求中填充 API 令牌头 abc123。

通过带前缀的环境变量进行配置

然而，在多个应用程序在同一台机器上运行而不使用容器的共享主机场景或开发环境中，为环境变量添加前缀并不少见。以下示例假设 HTTP 端点和 API 令牌都将从前缀为 “myapp_” 的环境变量中提取。在此场景中使用的两个环境变量如下：

键值
myapp_DAPR_HTTP_ENDPOINThttp://localhost:54321
myapp_DAPR_API_TOKENabc123

这些环境变量将在以下示例中加载到已注册的配置中，并在不带前缀的情况下可用。

var builder = WebApplication.CreateBuilder();

builder.Configuration.AddEnvironmentVariables(prefix: "myapp_");
builder.Services.AddDaprJobsClient();

Dapr Jobs 客户端将被配置为使用 HTTP 端点 http://localhost:54321，并在所有出站请求中填充 API 令牌头 abc123。

在不依赖依赖注入的情况下使用 Dapr Jobs 客户端

虽然使用依赖注入简化了 .NET 中复杂类型的使用，并使处理复杂配置变得更加容易，但你并不需要以这种方式注册 DaprJobsClient。相反，你也可以选择从 DaprJobsClientBuilder 实例创建它的实例，如下所示：


public class MySampleClass
{
    public void DoSomething()
    {
        var daprJobsClientBuilder = new DaprJobsClientBuilder();
        var daprJobsClient = daprJobsClientBuilder.Build();

        //使用 `daprJobsClient` 做一些事情
    }
}

设置一个在任务触发时被调用的端点

如果你对 ASP.NET Core 中的最小 API 有点熟悉，那么设置任务端点就很简单，因为两者的语法是相同的。

完成依赖注入注册后，像处理通过 ASP.NET Core 中的最小 API 功能映射 HTTP 请求那样配置应用程序。作为扩展方法实现，传入它应该响应的任务名称和一个委托。你可以根据需要将服务注入到委托的参数中，并且可以从最初提供给任务注册的 ReadOnlyMemory<byte> 访问任务负载。

这里可以使用两个委托。如果你需要将其他服务注入到处理程序中，其中一个提供 IServiceProvider：

//我们从上面的示例中得到这个
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient();

var app = builder.Build();

//添加我们的端点注册
app.MapDaprScheduledJob("myJob", (IServiceProvider serviceProvider, string jobName, ReadOnlyMemory<byte> jobPayload) => {
    var logger = serviceProvider.GetService<ILogger>();
    logger?.LogInformation("Received trigger invocation for '{jobName}'", "myJob");

    //做一些事情...
});

app.Run();

如果没有必要，委托的另一个重载不需要 IServiceProvider：

//我们从上面的示例中得到这个
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient();

var app = builder.Build();

//添加我们的端点注册
app.MapDaprScheduledJob("myJob", (string jobName, ReadOnlyMemory<byte> jobPayload) => {
    //做一些事情...
});

app.Run();

在处理映射调用时支持取消令牌

你可能希望确保在任务调用时处理超时，这样它们就不会无限期挂起并使用系统资源。在设置任务映射时，有一个可选的 TimeSpan 参数可以作为最后一个参数提供，以指定请求的超时时间。每次触发任务映射调用时，都会使用此超时参数创建一个新的 CancellationTokenSource，并从中创建一个 CancellationToken 来限制请求的处理时间。如果未提供超时，则默认为 CancellationToken.None，并且不会自动对映射应用超时。

//我们从上面的示例中得到这个
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient();

var app = builder.Build();

//添加我们的端点注册
app.MapDaprScheduledJob("myJob", (string jobName, ReadOnlyMemory<byte> jobPayload) => {
    //做一些事情...
}, TimeSpan.FromSeconds(15)); //为处理调用请求分配最大 15 秒的超时时间

app.Run();

注册任务

最后，我们必须注册要调度的任务。请注意，从这里开始，所有 SDK 方法都支持取消令牌，如果未另外设置，则使用默认令牌。

有三种不同的方式来设置任务，具体取决于你想如何配置调度。以下显示了调度任务时可用的不同参数：

参数名称类型描述必填
jobNamestring正在调度的任务的名称。是
scheduleDaprJobSchedule定义任务何时触发的调度。是
payloadReadOnlyMemory在触发时提供给调用端点的任务数据。否
startingFromDateTime任务调度应开始的时间点。否
repeatsint任务应触发的最大次数。否
ttl任务何时应过期且不再触发。否
overwritebool一个标志，指示提交时是否应覆盖现有任务，如果为 false，则需要先删除同名的现有任务。否
cancellationTokenCancellationToken用于提前取消操作，例如由于操作超时。否

DaprJobSchedule

所有任务都是通过 SDK 使用 DaprJobSchedule 调度的，它创建一个传递给运行时的表达式来调度任务。DaprJobSchedule 上公开了几个静态方法，用于简化每种可用任务调度的注册，如下所示。这将指定任务调度本身与任何其他选项（如重复操作或提供取消令牌）分离开来。

一次性任务

一次性任务就是这样；它将在单个时间点运行，不会重复。

这种方法要求你选择一个任务名称并指定它应该被触发的时间。

DaprJobSchedule.FromDateTime(DateTimeOffset scheduledTime)

一次性任务可以从 Dapr Jobs 客户端调度，如下例所示：

public class MyOperation(DaprJobsClient daprJobsClient)
{
    public async Task ScheduleOneTimeJobAsync(CancellationToken cancellationToken)
    {
        var today = DateTimeOffset.UtcNow;
        var threeDaysFromNow = today.AddDays(3);

        var schedule = DaprJobSchedule.FromDateTime(threeDaysFromNow);
        await daprJobsClient.ScheduleJobAsync("job", schedule, cancellationToken: cancellationToken);
    }
}

基于间隔的任务

基于间隔的任务是在配置为固定时间的循环上运行的任务，就像今天 Actors 构建块中的 提醒 的工作方式一样。

DaprJobSchedule.FromDuration(TimeSpan interval)

基于间隔的任务可以从 Dapr Jobs 客户端调度，如下例所示：

public class MyOperation(DaprJobsClient daprJobsClient)
{

    public async Task ScheduleIntervalJobAsync(CancellationToken cancellationToken)
    {
        var hourlyInterval = TimeSpan.FromHours(1);

        //每小时触发一次任务，但最多 5 次
        var schedule = DaprJobSchedule.FromDuration(hourlyInterval);
        await daprJobsClient.ScheduleJobAsync("job", schedule, repeats: 5, cancellationToken: cancellationToken);
    }
}

基于 Cron 的任务

基于 Cron 的任务是使用 Cron 表达式调度的。这提供了更多基于日历的控制，因为可以在表达式中使用基于日历的值。

DaprJobSchedule.FromCronExpression(string cronExpression)

在 Dapr SDK 中，支持两种不同的方法来调度基于 Cron 的任务。

提供你自己的 Cron 表达式

你可以通过 DaprJobSchedule.FromExpression() 通过字符串提供你自己的 Cron 表达式：

public class MyOperation(DaprJobsClient daprJobsClient)
{
    public async Task ScheduleCronJobAsync(CancellationToken cancellationToken)
    {
        //在每月第五天的每隔一小时的顶部
        const string cronSchedule = "0 */2 5 * *";
        var schedule = DaprJobSchedule.FromExpression(cronSchedule);

        //直到下个月才开始
        var now = DateTime.UtcNow;
        var oneMonthFromNow = now.AddMonths(1);
        var firstOfNextMonth = new DateTime(oneMonthFromNow.Year, oneMonthFromNow.Month, 1, 0, 0, 0);

        await daprJobsClient.ScheduleJobAsync("myJobName", )
        await daprJobsClient.ScheduleCronJobAsync("myJobName", schedule, dueTime: firstOfNextMonth, cancellationToken: cancellationToken);
    }
}

使用 CronExpressionBuilder

或者，你可以使用我们的流畅构建器来生成有效的 Cron 表达式：

public class MyOperation(DaprJobsClient daprJobsClient)
{
    public async Task ScheduleCronJobAsync(CancellationToken cancellationToken)
    {
        //在每月第五天的每隔一小时的顶部
        var cronExpression = new CronExpressionBuilder()
            .Every(EveryCronPeriod.Hour, 2)
            .On(OnCronPeriod.DayOfMonth, 5)
            .ToString();
        var schedule = DaprJobSchedule.FromExpression(cronExpression);

        //直到下个月才开始
        var now = DateTime.UtcNow;
        var oneMonthFromNow = now.AddMonths(1);
        var firstOfNextMonth = new DateTime(oneMonthFromNow.Year, oneMonthFromNow.Month, 1, 0, 0, 0);

        await daprJobsClient.ScheduleJobAsync("myJobName", )
        await daprJobsClient.ScheduleCronJobAsync("myJobName", schedule, dueTime: firstOfNextMonth, cancellationToken: cancellationToken);
    }
}

获取已调度任务的详细信息

如果你知道已调度任务的名称，你可以检索其元数据而无需等待它被触发。返回的 JobDetails 暴露了一些有用的属性，用于从 Dapr Jobs API 使用信息：

  • 如果 Schedule 属性包含 Cron 表达式，IsCronExpression 属性将为 true，表达式也可以在 CronExpression 属性中获得。
  • 如果 Schedule 属性包含持续时间值，IsIntervalExpression 属性将为 true，该值将转换为可从 Interval 属性访问的 TimeSpan 值。

可以通过使用以下内容来完成：

public class MyOperation(DaprJobsClient daprJobsClient)
{
    public async Task<JobDetails> GetJobDetailsAsync(string jobName, CancellationToken cancellationToken)
    {
        var jobDetails = await daprJobsClient.GetJobAsync(jobName, canecllationToken);
        return jobDetails;
    }
}

删除已调度的任务

要删除已调度的任务，你需要知道它的名称。从那里，就像在 Dapr Jobs 客户端上调用 DeleteJobAsync 方法一样简单：

public class MyOperation(DaprJobsClient daprJobsClient)
{
    public async Task DeleteJobAsync(string jobName, CancellationToken cancellationToken)
    {
        await daprJobsClient.DeleteJobAsync(jobName, cancellationToken);
    }
}

2 - DaprJobsClient 使用

使用 DaprJobsClient 的基本技巧和建议

生命周期管理

DaprJobsClient 是 Dapr 客户端的一个专用版本，专门用于与 Dapr Jobs API 交互。它可以与 DaprClient 及其他 Dapr 客户端一起注册，不会有任何问题。

它维护用于与 Dapr 边车通信的 TCP 套接字形式的网络资源访问，并实现 IDisposable 以支持资源的即时清理。

为了获得最佳性能，请创建一个单一的长生命周期 DaprJobsClient 实例，并在整个应用程序中提供对该共享实例的访问。DaprJobsClient 实例是线程安全的，旨在被共享。

这可以通过利用依赖注入功能来辅助实现。注册方法支持注册为单例、作用域实例或瞬态（意味着每次注入时都会重新创建），但还支持注册以利用来自 IConfiguration 或其他注入服务的值，这在每个类中从头开始创建客户端时是不切实际的。

避免为每次操作创建一个 DaprJobsClient 并在操作完成时将其释放。

通过 DaprJobsClientBuilder 配置 DaprJobsClient

可以通过在调用 .Build() 创建客户端本身之前调用 DaprJobsClientBuilder 类上的方法来配置 DaprJobsClient。每个 DaprJobsClient 的设置是独立的，在调用 .Build() 后无法更改。

var daprJobsClient = new DaprJobsClientBuilder()
    .UseDaprApiToken("abc123") // 指定用于向其他 Dapr 边车进行身份验证的 API 令牌
    .Build();

DaprJobsClientBuilder 包含以下设置：

  • Dapr 边车的 HTTP 端点
  • Dapr 边车的 gRPC 端点
  • 用于配置 JSON 序列化的 JsonSerializerOptions 对象
  • 用于配置 gRPC 的 GrpcChannelOptions 对象
  • 用于对边车请求进行身份验证的 API 令牌
  • 用于创建 SDK 使用的 HttpClient 实例的工厂方法
  • SDK 在向边车发出请求时 HttpClient 实例使用的超时时间

SDK 将读取以下环境变量来配置默认值：

  • DAPR_HTTP_ENDPOINT：用于查找 Dapr 边车的 HTTP 端点，例如：https://dapr-api.mycompany.com
  • DAPR_GRPC_ENDPOINT：用于查找 Dapr 边车的 gRPC 端点，例如：https://dapr-grpc-api.mycompany.com
  • DAPR_HTTP_PORT：如果未设置 DAPR_HTTP_ENDPOINT，则用于查找 Dapr 边车的 HTTP 本地端点
  • DAPR_GRPC_PORT：如果未设置 DAPR_GRPC_ENDPOINT，则用于查找 Dapr 边车的 gRPC 本地端点
  • DAPR_API_TOKEN：用于设置 API 令牌

配置 gRPC 通道选项

Dapr 使用 CancellationToken 进行取消依赖于 gRPC 通道选项的配置。如果您需要自己配置这些选项，请确保启用 ThrowOperationCanceledOnCancellation 设置。

var daprJobsClient = new DaprJobsClientBuilder()
    .UseGrpcChannelOptions(new GrpcChannelOptions { ... ThrowOperationCanceledOnCancellation = true })
    .Build();

在 DaprJobsClient 中使用取消操作

DaprJobsClient 上的 API 执行异步操作并接受一个可选的 CancellationToken 参数。这遵循 .NET 可取消操作的标准实践。请注意，当取消发生时，无法保证远程端点停止处理请求，只能保证客户端已停止等待完成。

当操作被取消时，它将抛出 OperationCancelledException。

通过依赖注入配置 DaprJobsClient

使用内置的扩展方法在依赖注入容器中注册 DaprJobsClient 可以带来以下好处：只需一次注册长生命周期服务、集中化复杂配置，并通过在可能的情况下重新使用类似的长生命周期资源（例如 HttpClient 实例）来提高性能。

提供了三种重载，以便开发人员为其场景配置客户端时具有最大的灵活性。如果尚未注册 IHttpClientFactory，每种方法都会代表您注册它，并配置 DaprJobsClientBuilder 在创建 HttpClient 实例时使用它，以便尽可能重复使用相同的实例，并避免套接字耗尽和其他问题。

在第一种方法中，开发人员不进行任何配置，DaprJobsClient 使用默认设置进行配置。

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient(); // 注册 `DaprJobsClient` 以便按需注入
var app = builder.Build();

有时开发人员需要使用上面详述的各种配置选项来配置创建的客户端。这是通过传入 DaprJobsClientBuilder 的重载来完成的，该重载公开了用于配置必要选项的方法。

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDaprJobsClient((_, daprJobsClientBuilder) => {
   // 设置 API 令牌
   daprJobsClientBuilder.UseDaprApiToken("abc123");
   // 指定非标准的 HTTP 端点
   daprJobsClientBuilder.UseHttpEndpoint("http://dapr.my-company.com");
});

var app = builder.Build();

最后，开发人员可能需要从另一个服务检索信息以填充这些配置值。该值可能来自 DaprClient 实例、特定于供应商的 SDK 或某些本地服务，但只要它也在 DI 中注册，就可以通过最后一个重载注入到此配置操作中：

var builder = WebApplication.CreateBuilder(args);

// 注册一个从某处检索机密的虚构服务
builder.Services.AddSingleton<SecretService>();

builder.Services.AddDaprJobsClient((serviceProvider, daprJobsClientBuilder) => {
    // 从服务提供程序检索 `SecretService` 的实例
    var secretService = serviceProvider.GetRequiredService<SecretService>();
    var daprApiToken = secretService.GetSecret("DaprApiToken").Value;

    // 配置 `DaprJobsClientBuilder`
    daprJobsClientBuilder.UseDaprApiToken(daprApiToken);
});

var app = builder.Build();

理解 DaprJobsClient 上的负载序列化

虽然 DaprClient 上有许多方法可以使用 System.Text.Json 序列化程序自动序列化和反序列化数据，但此 SDK 采用不同的理念。相反，相关方法接受一个可选的 ReadOnlyMemory<byte> 负载，这意味着序列化是留给开发人员的练习，通常不由 SDK 处理。

也就是说，对于每种调度方法，都有一些辅助扩展方法可用。如果您知道要使用可 JSON 序列化的类型，可以对每种调度类型使用 Schedule*WithPayloadAsync 方法，该方法接受一个 object 作为负载，并接受一个可选的 JsonSerializerOptions 在序列化值时使用。为了方便起见，这将把值转换为 UTF-8 编码的字节。这是调度 Cron 表达式时的示例：

public sealed record Doodad (string Name, int Value);

//...
var doodad = new Doodad("Thing", 100);
await daprJobsClient.ScheduleCronJobWithPayloadAsync("myJob", "5 * * * *", doodad);

同样，如果您有一个纯字符串值，可以使用同一方法的重载来序列化字符串类型的负载，将跳过 JSON 序列化步骤，并且只会编码为 UTF-8 编码的字节数组。这是调度一次性作业时的示例：

var now = DateTime.UtcNow;
var oneWeekFromNow = now.AddDays(7);
await daprJobsClient.ScheduleOneTimeJobWithPayloadAsync("myOtherJob", oneWeekFromNow, "This is a test!");

处理作业调用的委托期望至少存在两个参数：

  • 一个填充了 jobName 的 string，提供被调用作业的名称
  • 一个填充了作业注册期间最初提供的字节的 ReadOnlyMemory<byte>

由于负载存储为 ReadOnlyMemory<byte>，开发人员可以自由地序列化和反序列化，但同样包含两个辅助扩展，可以将其反序列化为 JSON 兼容类型或字符串。两种方法都假定开发人员对最初调度的作业进行了编码（可能使用了辅助序列化方法），因为这些方法不会强制字节表示它们不是的内容。

要将字节反序列化为字符串，可以使用以下辅助方法：

var payloadAsString = Encoding.UTF8.GetString(jobPayload.Span); // 如果成功，则返回包含值的字符串

错误处理

如果在 SDK 和运行在 Dapr 边车上的 Jobs API 服务之间遇到问题，DaprJobsClient 上的方法将抛出 DaprJobsServiceException。如果由于通过此 SDK 向 Jobs API 服务发出的格式错误的请求而导致失败，将抛出 DaprMalformedJobException。在非法参数值的情况下，将抛出相应的标准异常（例如 ArgumentOutOfRangeException 或 ArgumentNullException）以及违规参数的名称。对于其他任何情况，将抛出 DaprException。

最常见的失败情况与以下内容相关：

  • 与 Jobs API 交互时参数格式不正确
  • 瞬态故障，例如网络问题
  • 无效数据，例如无法将值反序列化回最初未序列化的类型

在任何这些情况下，您都可以通过 .InnerException 属性检查更多异常详细信息。