Azure Durable Function：为触发函数的202响应添加自定义头

核心问题根源 #

DurableTaskClient自动生成的202响应会被框架后续处理环节接管，直接修改原始响应对象的头信息会被覆盖，必须在响应生成后、框架最终处理前介入修改。

可行解决方案 #

方案一：直接修改CreateCheckStatusResponse返回对象（推荐，适用于进程内/隔离进程模型）

默认触发函数通过CreateCheckStatusResponse生成响应，直接操作该返回对象添加自定义头，框架会保留原有头和响应体：

[FunctionName("StartOrchestration")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = null)] HttpRequest req,
    [DurableClient] IDurableOrchestrationClient client)
{
    var instanceId = await client.StartNewAsync("YourOrchestrationName", null);
    // 获取Durable生成的原始响应
    var durableResponse = client.CreateCheckStatusResponse(req, instanceId);
    
    // 添加自定义请求头
    durableResponse.Headers.Add("X-Custom-Header", "YourCustomValue");
    
    return durableResponse;
}

方案二：正确配置隔离进程模型中间件

如果使用隔离进程模型，之前中间件失效大概率是注册顺序或响应拦截时机错误，需确保中间件在Durable相关管道后执行，并在响应生成后修改：

1. 实现中间件：

public class CustomHeaderMiddleware : IFunctionsWorkerMiddleware
{
    public async Task Invoke(FunctionContext context, FunctionExecutionDelegate next)
    {
        // 先执行后续管道（包括Durable响应生成）
        await next(context);
        
        // 仅针对Durable触发的202响应添加自定义头
        if (context.GetHttpResponseData() is { StatusCode: HttpStatusCode.Accepted } response)
        {
            response.Headers.Add("X-Custom-Header", "YourCustomValue");
        }
    }
}

2. 在Program.cs中正确注册：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        // 确保中间件在默认管道之后添加
        builder.UseMiddleware<CustomHeaderMiddleware>();
    })
    .Build();

host.Run();

方案三：进程内模型用HttpResponseMessage返回

进程内模型中，也可以直接返回HttpResponseMessage，基于Durable的原始响应修改：

[FunctionName("StartOrchestration")]
public static async Task<HttpResponseMessage> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = null)] HttpRequestMessage req,
    [DurableClient] IDurableOrchestrationClient client)
{
    var instanceId = await client.StartNewAsync("YourOrchestrationName", null);
    var response = client.CreateCheckStatusResponse(req, instanceId) as HttpResponseMessage;
    
    response.Headers.Add("X-Custom-Header", "YourCustomValue");
    return response;
}

之前方案失效原因说明 #

• 直接调用response.Headers.Add无效果：进程内模型中，HttpTrigger的原始响应对象会被Durable的后续逻辑覆盖，必须操作CreateCheckStatusResponse返回的对象。
• 中间件无效果：隔离进程模型中，中间件注册顺序错误（需在Durable管道之后），或拦截时机过早（需在响应生成后修改）。

内容的提问来源于stack exchange，提问作者Michal B.