Azure Functions独立工作者(.NET8)：ActivityTrigger字符串被额外加引号

1. 参数被添加额外引号的原因 #

核心原因是进程内模型与独立工作者模型的Durable Functions序列化机制差异：

• .NET6进程内模型中，Durable Functions直接使用与函数运行时集成的序列化逻辑，传递原始字符串时会按值直接传递，不会额外包裹JSON引号。
• .NET8独立工作者模型基于gRPC通信，DurableTask的序列化管道会将所有参数当作JSON对象处理。当传递原始字符串时，序列化器会把它视为JSON字符串类型（自动添加引号包裹），而活动函数的[ActivityTrigger]绑定在反序列化时，错误地将这个带引号的JSON字符串当作了原始字符串值，最终导致参数带上额外引号。

2. 是否存在已知的字符串处理问题 #

这不是SDK的bug，而是独立工作者模型的预期行为差异，属于迁移时的常见适配问题。独立工作者模型的序列化管道与进程内模型不同，简单类型（如字符串、数字）的传递方式会有变化，容易出现双重序列化/反序列化的情况。

3. 解决方法与排查方向 #

解决方法 #

方法1：用强类型DTO包装参数（推荐）

将原始字符串参数包装在简单的数据传输对象（DTO）中，让序列化器正确处理对象属性，避免字符串被当作JSON值包裹：

// 定义DTO
public class JobIdDto
{
    public string JobId { get; set; }
}

// 编排器调用
public async Task<JobResult> Run([OrchestrationTrigger] TaskOrchestrationContext ctx)
{
    await ctx.CallActivityAsync<bool>(nameof(IsCancellationRequested), new JobIdDto { JobId = jobId });
}

// 活动函数接收
[Function(nameof(IsCancellationRequested))]
public Task<bool> IsCancellationRequested([ActivityTrigger] JobIdDto dto)
{
    return jobService.IsCancellationRequested(dto.JobId);
}

方法2：调整DurableTask序列化配置

在Program.cs中显式配置DurableTask的JSON序列化选项，确保字符串处理逻辑与预期一致：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAzureFunctionsWorker();
builder.Services.AddDurableTask(options =>
{
    // 配置序列化选项，避免字符串过度转义
    options.JsonSerializerOptions = new System.Text.Json.JsonSerializerOptions
    {
        PropertyNameCaseInsensitive = true,
        Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
        WriteIndented = false
    };
});

方法3：临时手动去除引号（不推荐，仅应急）

如果需要快速临时修复，可以在活动函数中手动修剪引号：

[Function(nameof(IsCancellationRequested))]
public Task<bool> IsCancellationRequested([ActivityTrigger] string jobId)
{
    // 去除首尾引号
    var cleanedJobId = jobId.Trim('"');
    return jobService.IsCancellationRequested(cleanedJobId);
}

排查方向 #

• 检查SDK版本：确保使用最新版的Microsoft.Azure.Functions.Worker.Extensions.DurableTask，早期版本可能存在序列化逻辑不完善的问题。
• 全局序列化配置冲突：排查Program.cs中是否有全局JSON序列化设置（如builder.Services.Configure<JsonSerializerOptions>(...)），导致与DurableTask的序列化选项冲突。
• 绑定类型匹配：确认活动函数的[ActivityTrigger]参数类型与编排器传递的参数类型完全匹配，避免隐式类型转换导致的序列化异常。

内容的提问来源于stack exchange，提问作者Сергій Ярошевич