带路径参数的Azure Function在Azure Function App上无法运行求助

可能的原因及解决方案 #

1. 修正函数命名与路由配置 #

你当前的[Function("Get/{id}")]写法错误——Azure Functions的函数名称不能包含/这类路径分隔符，它是函数的唯一标识，而非路由规则。正确的做法是单独指定函数名，通过HttpTrigger的Route属性定义路径：

[Function("GetById")]
public async Task<HttpResponseData> RunByIdAsync(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = "Get/{id}")] HttpRequestData req, 
    string id)
{
    // 你的业务逻辑代码
}

2. 规范function.json配置（若使用） #

如果手动添加了function.json，需确保配置与代码注解一致，且无语法错误。同时避免代码注解与手动配置重复生效，推荐优先使用代码注解（.NET Isolated模式更适配）。正确的function.json示例：

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get"],
      "route": "Get/{id}"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    }
  ],
  "scriptFile": "../bin/YourAssembly.dll",
  "entryPoint": "YourNamespace.YourClass.RunByIdAsync"
}

部署时确认该文件被正确打包上传至对应函数目录。

3. 检查路由前缀设置 #

登录Azure门户进入你的Function App，在配置→应用程序设置中查看AzureWebJobsRoutePrefix项。若设置了前缀（比如api），访问路径需加上该前缀，例如https://your-app.azurewebsites.net/api/Get/123，而非直接访问/Get/123。

4. 验证部署包完整性 #

通过Azure门户的高级工具(Kudu)→调试控制台→CMD，进入site/wwwroot目录，检查对应函数文件夹下的dll、function.json等文件是否完整，代码是否为最新版本，排除部署时文件缺失或未更新的问题。

5. 查看Azure端详细错误日志 #

在Function App的监控→日志中打开日志流，访问报错接口后查看具体错误信息（如路由匹配失败、参数绑定异常等），根据日志定位问题——比如参数名称不匹配、类型转换错误等。

6. 确认.NET Isolated模式配置（若适用） #

如果使用.NET Isolated模式，确保Program.cs的基础配置正确，避免自定义中间件干扰路径参数解析：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .Build();

host.Run();

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