如何配置Azure Function Proxy适配本地与Azure双环境？

针对基于.NET7、Azure Functions 4.x独立模式的API服务，要实现根路径/指向Swagger UI且同时适配本地和Azure环境，核心问题是之前的配置硬编码了固定环境地址，导致无法跨环境通用。下面是具体的解决方案：

步骤1：修改proxies.json使用环境变量 #

将Proxy配置中的目标地址替换为环境变量引用，让配置根据运行环境自动加载对应地址：

{
  "$schema": "http://json.schemastore.org/proxies",
  "proxies": {
    "swagger-root-redirect": {
      "matchCondition": {
        "methods": [ "GET" ],
        "route": "/"
      },
      "responseOverrides": {
        "response.statusCode": "302",
        "response.headers.Location": "%SwaggerUiUrl%"
      }
    }
  }
}

这里采用重定向方案而非转发，因为转发在Azure环境中可能存在内部地址访问限制，重定向的适配性和可靠性更强。

步骤2：配置本地环境变量 #

在local.settings.json的Values节点中添加本地Swagger UI的地址：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "AzureWebJobsFeatureFlags": "EnableProxies",
    "AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL": "true",
    "SwaggerUiUrl": "http://localhost:7071/swagger/ui"
  }
}

步骤3：配置Azure生产环境变量 #

部署到Azure后，在函数应用的配置 -> 应用程序设置中添加同名变量SwaggerUiUrl，值设为你的Azure函数应用域名对应的Swagger地址，示例：

https://your-function-app-name.azurewebsites.net/swagger/ui

验证配置 #

• 本地运行：启动函数应用后访问http://localhost:7071/，会自动重定向到本地Swagger UI
• Azure环境：部署完成后访问函数应用根域名，会重定向到Azure上的Swagger UI

补充说明 #

• 确保host.json中http.routePrefix已设为空字符串，这样根路径/才能被Proxy匹配
• 独立模式下Proxy功能需要通过AzureWebJobsFeatureFlags: EnableProxies启用，你的现有配置已包含该项，无需修改

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