Azure Durable Function大文件上传：解决Grpc消息大小超限问题

一、修改Grpc消息大小限制配置 #

1. 本地开发环境（local.settings.json） #

在项目的local.settings.json文件中，添加Durable Task的Grpc消息大小配置项，值为你需要的最大接收消息字节数（例如16MB对应16777216）：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "DurableTask:Grpc:MaxReceiveMessageSize": "16777216"
  }
}

2. Azure部署环境（应用程序设置） #

登录Azure门户，进入你的函数应用，依次点击配置→应用程序设置，添加新的配置项：

• 名称：DurableTask:Grpc:MaxReceiveMessageSize
• 值：设置为目标字节数（如33554432对应32MB）

二、代码层面自定义配置（.NET场景） #

如果需要在代码中灵活控制，可以在Program.cs或Startup类中配置Durable Task客户端的Grpc选项：

using Microsoft.DurableTask.Client;
using Microsoft.Extensions.DependencyInjection;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        // 设置为16MB，可根据需求调整
        services.AddDurableTaskClient(options => options.Grpc.MaxReceiveMessageSize = 16 * 1024 * 1024);
    })
    .Build();

host.Run();

三、大文件处理最佳实践 #

直接将大文件的base64字符串作为编排输入并非最优方案，建议优化流程：

• 先将解码后的文件直接上传至Blob存储，获取Blob的访问路径或URL
• 将Blob路径作为参数传递给Durable Orchestration，在编排逻辑中通过路径读取Blob内容完成后续操作
  这种方式既能规避Grpc消息大小限制，还能提升整体性能与可靠性。

内容的提问来源于stack exchange，提问作者SomeGuy