如何让Azure Function的host.json路由前缀配置仅在本地生效？

共有两种成熟方案可以实现host.json配置仅本地生效：

方案1：使用多环境host.json文件+本地构建规则 #

• 首先保留云端使用的默认host.json文件，移除其中的routePrefix配置，保证云端部署正常
• 在本地项目根目录新增host.local.json文件，写入你需要的本地专属配置：

{
  "extensions": {
    "http": { "routePrefix": "template" }
  }
}

• 编辑本地项目的配置文件（C#项目编辑.csproj，其他语言项目调整本地启动脚本），添加规则：本地运行时优先读取host.local.json覆盖host.json的配置，部署到云端时仅上传默认的host.json即可。也可以写简单的本地脚本，启动前替换host.json内容，启动结束后恢复原始配置。

方案2：使用环境变量替代硬编码配置（推荐） #

Azure Function运行时原生支持从环境变量读取host.json的配置值，无需硬写在配置文件中：

• 把host.json里的routePrefix值替换为环境变量占位符：

{
  "extensions": {
    "http": { "routePrefix": "%FUNCTION_ROUTE_PREFIX%" }
  }
}

• 本地开发时，在项目的local.settings.json的Values节点下添加配置：

{
  "Values": {
    "FUNCTION_ROUTE_PREFIX": "template",
    // 其余本地配置保留即可
  }
}

• 云端Azure Function的应用设置里，添加同名配置FUNCTION_ROUTE_PREFIX，值设为你需要的云端路由前缀，默认留空即可对应原生无前缀的行为
• 该方案无需修改构建部署逻辑，所有配置随环境自动加载，不会出现配置冲突。local.settings.json默认被.gitignore规则排除，不会提交到代码仓库、也不会部署到云端，完全不影响线上运行。

内容的提问来源于stack exchange，提问作者Daniel Assumpção