本地运行Azure Functions报错：HttpRequestMessage无GetQueryNameValuePairs定义

这个问题我之前也碰到过，核心原因是你本地使用的Azure Functions Core Tools版本和Azure门户上函数应用的运行时版本不匹配，导致Http请求相关的API调用出现兼容性错误。你在Azure门户上创建的默认Http触发器应该是基于v1运行时的，而本地工具大概率是v2及以上版本，这两个版本的Http请求处理API有明显差异。

先看你遇到的两个错误：

[5/22/18 9:03:21 PM] run.csx(8,23): error CS1061: 'HttpRequestMessage' does not contain a definition for 'GetQueryNameValuePairs' and no extension method 'GetQueryNameValuePairs' accepting a first argument of type 'HttpRequestMessage' could be found (are you missing a using directive or an assembly reference?)
[5/22/18 9:03:21 PM] run.csx(20,15): error CS1501: No overload for method 'CreateResponse' takes 2 arguments

这两个错误都是因为v2+运行时不再使用HttpRequestMessage作为请求参数，而是改用HttpRequest，同时相关的响应创建方法也做了调整。下面给你两种解决方案：

方案一：修改代码适配本地新运行时（推荐） #

把原来基于v1运行时的代码改成适配v2+版本的写法，替换掉过时的API：

原来的v1代码大概是这样：

public static async Task<HttpResponseMessage> Run(HttpRequestMessage req, TraceWriter log)
{
    log.Info("C# HTTP trigger function processed a request.");

    // parse query parameter
    string name = req.GetQueryNameValuePairs()
        .FirstOrDefault(q => string.Compare(q.Key, "name", true) == 0)
        .Value;

    if (name == null)
    {
        // Get request body
        dynamic data = await req.Content.ReadAsAsync<object>();
        name = data?.name;
    }

    return name == null
        ? req.CreateResponse(HttpStatusCode.BadRequest, "Please pass a name on the query string or in the request body")
        : req.CreateResponse(HttpStatusCode.OK, "Hello " + name);
}

修改为适配v2+的代码：

using System.IO;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;

public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    string name = req.Query["name"];

    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    dynamic data = JsonConvert.DeserializeObject(requestBody);
    name = name ?? data?.name;

    return name != null
        ? (ActionResult)new OkObjectResult($"Hello, {name}")
        : new BadRequestObjectResult("Please pass a name on the query string or in the request body");
}

方案二：安装对应v1版本的Functions Core Tools #

如果你想保留原有代码不修改，可以安装v1版本的本地开发工具，通过npm命令执行：

npm install -g azure-functions-core-tools@1

安装完成后重新运行本地函数，就能和Azure门户的v1运行时保持兼容了。

最后提醒你：可以在Azure门户的函数应用 -> 设置 -> 配置 -> 常规设置里，查看当前函数应用的"运行时版本"，确保本地工具版本和它完全匹配，这样就能避免类似的兼容问题。

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