Azure静态Web Apps第二个C# Function API绑定[FromBody]失败求助

在VS Code中通过「Azure Static Web Apps: Create HTTP Function」命令创建C# Function应用，项目已引入Microsoft.NET.Sdk.Functions 4.1.1包。第一个GET函数GetDocumentSignatureStatus可正常调用，但同一类中添加的POST函数SignDocumentForUser使用[FromBody]参数时，触发以下错误：

[api] [2023-07-11T17:16:16.321Z] An unhandled host error has occurred.
[api] [2023-07-11T17:16:16.321Z] Microsoft.Azure.WebJobs.Host: 'SignDocumentForUser' can't be invoked from Azure WebJobs SDK. Is it missing Azure WebJobs SDK attributes?.

构建输出提示参数绑定索引错误：

[api] [2023-07-14T13:17:41.768Z] Microsoft.Azure.WebJobs.Host: Error indexing method 'SignDocumentForUser'. Make sure the parameter Type is supported by the binding. If you're using binding extensions (e.g. Azure Storage, Service Bus), make sure you've called the registration method for the extension(s) in your startup code (e.g. builder.AddAzureStorage(), builder.AddServiceBus()).
[api] [2023-07-14T13:17:41.773Z] Error indexing method 'SignDocumentForUser'

移除[FromBody]参数后函数可正常运行，但无法实现请求体参数绑定。

解决方案 #

核心原因 #

Azure Functions的HttpTrigger绑定中，不能同时声明HttpRequest参数和[FromBody]参数。WebJobs SDK会将HttpRequest视为包含请求体的整体绑定，重复使用[FromBody]会导致绑定冲突，触发索引错误。

两种修复方案 #

方案1：移除HttpRequest，直接使用[FromBody]绑定模型

删除HttpRequest req参数，让WebJobs SDK直接将请求体反序列化为UserSignature对象：

[FunctionName("SignDocumentForUser")]
public static async Task<IActionResult> Sign(
    [HttpTrigger(AuthorizationLevel.User, "post", Route = "departments/{dept:alpha}/documents/{doc}/versions/{version}/signatures")]
    ILogger log, 
    string dept, string doc, string version,
    [FromBody]UserSignature signature)
{
    // 你的业务实现逻辑
}

方案2：保留HttpRequest，手动读取并反序列化请求体

如果需要保留HttpRequest用于其他操作（比如读取请求头），则手动从请求体中读取内容并反序列化：

using System.Text.Json;

[FunctionName("SignDocumentForUser")]
public static async Task<IActionResult> Sign(
    [HttpTrigger(AuthorizationLevel.User, "post", Route = "departments/{dept:alpha}/documents/{doc}/versions/{version}/signatures")]
    HttpRequest req, 
    ILogger log, 
    string dept, string doc, string version)
{
    // 读取请求体内容
    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    // 反序列化为UserSignature对象
    UserSignature signature = JsonSerializer.Deserialize<UserSignature>(requestBody);
    
    // 你的业务实现逻辑
}

额外注意事项 #

• 确保UserSignature类具备无参公共构造函数，且所有需要绑定的属性为公共可读写，否则反序列化会失败。
• 调用接口时，确保请求的Content-Type设置为application/json，否则请求体无法被正确解析。

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