Durable Function v3无法返回大于80MB的Excel文件问题求助

现象原因 #

当Excel文件超过80MB时，转成base64后体积会增加约33%（达到约107MB），触发了两个核心限制：

1. Durable Orchestrator状态存储限制：Orchestrator的返回结果会被序列化为JSON并存储在任务中心的Azure Storage中，默认配置下，超过一定大小的内容无法正常持久化到Table Storage（单实体上限1MB），即使代码执行完成，状态持久化操作卡住，导致外部查询状态时始终返回202（运行中）。
2. HTTP响应大小限制：Azure Functions的HTTP响应默认存在大小上限（约100MB），这么大的base64字符串无法通过网关正常返回给客户端，进一步加剧了状态异常。

解决方案 #

1. 优先采用Blob Storage存储大文件（推荐） #

不再直接返回base64编码内容，而是将Excel文件上传到Azure Blob Storage，返回带权限的SAS URL供客户端下载，Orchestrator仅返回轻量元数据：

// 初始化Blob客户端（需注入或实例化BlobServiceClient）
var containerClient = blobServiceClient.GetBlobContainerClient("training-reports");
await containerClient.CreateIfNotExistsAsync();

// 生成唯一Blob名称
var blobName = $"enrollment-report-{ticket.Tenant}-{Guid.NewGuid()}.xlsx";
var blobClient = containerClient.GetBlobClient(blobName);

// 上传Excel文件内容
await blobClient.UploadAsync(new MemoryStream(reportContent), overwrite: true);

// 生成1小时有效期的只读SAS URL
var sasBuilder = new BlobSasBuilder(BlobSasPermissions.Read, DateTimeOffset.UtcNow.AddHours(1))
{
    BlobContainerName = containerClient.Name,
    BlobName = blobName,
    Resource = "b"
};
var sasUrl = blobClient.GenerateSasUri(sasBuilder).ToString();

// 返回包含SAS URL的响应对象
return new EnrollmentsReportResponse()
{
    Success = true,
    ErrorMessage = string.Empty,
    Options = options,
    BlobSasUrl = sasUrl // 替换原FileAsBase64字段
};

2. 配置Durable Functions大消息存储（兼容方案） #

如果必须返回文件内容，可以修改host.json配置，让超过阈值的消息自动存储到Blob Storage，绕过Table Storage的大小限制：

{
  "extensions": {
    "durableTask": {
      "storageProvider": {
        "type": "AzureStorage",
        "largeMessageThreshold": 65536, // 超过64KB的内容将存储到Blob
        "connectionStringName": "AzureWebJobsStorage"
      }
    }
  }
}

注意：此方案仅解决Orchestrator状态存储问题，HTTP响应大小限制依然存在，大文件仍可能无法正常返回给客户端。

3. 业务层面拆分大文件（可选） #

如果业务逻辑允许，将大Excel文件按规则拆分（如按部门、日期区间）为多个小文件，分别生成Blob URL返回，由客户端自行合并处理。

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