Azure函数：路由含连字符的参数如何绑定到合法参数名？

在Azure Functions中，C#参数名不允许包含连字符，而路由占位符使用my-guid时，直接绑定到myGuid参数会触发绑定错误，以下是两种可行的解决方式：

方法一：使用[FromRoute]特性显式绑定 #

确保项目已引用Microsoft.AspNetCore.Mvc包，然后在参数上通过Name属性指定路由占位符名称：

[FunctionName("MyFunction")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "x/{my-guid}/y")] HttpRequest httpRequest,
    [FromRoute(Name = "my-guid")] Guid myGuid,
    ILogger logger
)

注意：若使用.NET 6+的Isolated Worker独立进程模型，需在函数类上添加[ApiController]特性，才能使[FromRoute]生效。

方法二：手动从HttpRequest提取路由值 #

如果[FromRoute]特性无法生效，可直接从请求的路由值集合中解析参数，这种方式兼容所有Functions运行模型：

[FunctionName("MyFunction")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "x/{my-guid}/y")] HttpRequest httpRequest,
    ILogger logger
)
{
    if (!Guid.TryParse(httpRequest.RouteValues["my-guid"]?.ToString(), out Guid myGuid))
    {
        return BadRequest("无效的GUID格式");
    }
    // 后续业务逻辑
}

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