Docker本地运行Azure Function热更新时无HTTP路由映射问题

容器启动后提示No HTTP routes mapped核心由两个配置错误导致：

• 环境变量AzureWebJobsScriptRoot被手动指向/home/site/wwwroot，但该目录为空，C#类库模式的Azure Function运行时找不到编译生成的程序集、函数元数据文件，自然无法扫描到HTTP路由。
• 启动命令直接执行func host start，没有配套dotnet自动构建、代码监听逻辑，既没有现成的编译产物供运行时加载，也无法实现代码变更自动热更新。
  本地VS调试时路由正常，是因为VS会自动完成项目编译、把生成的产物输出到运行时默认扫描的bin目录，不存在路径不匹配、无编译产物的问题。

1. 替换Dockerfile配置 #

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
EXPOSE 80

# 安装系统依赖、Node.js、Azure Functions Core Tools v4、VS调试工具
RUN apt-get update && \
    apt-get -y install curl gnupg unzip coreutils && \
    curl -fsSL https://deb.nodesource.com/setup_14.x | bash - && \
    apt-get -y install nodejs && \
    npm i -g azure-functions-core-tools@4 --unsafe-perm true && \
    curl -sSL https://aka.ms/getvsdbgsh | /bin/sh /dev/stdin -v latest -l ~/vsdbg

WORKDIR /src
# 先拷贝项目文件执行还原，利用Docker构建缓存
COPY ["FunctionApp1.csproj", "./"]
RUN dotnet restore "FunctionApp1.csproj"
# 拷贝全量项目代码
COPY . .

# 配置运行时环境变量，开启文件轮询监听适配容器卷挂载场景
ENV AzureFunctionsJobHost__Logging__Console__IsEnabled=true \
    DOTNET_USE_POLLING_FILE_WATCHER=1 \
    ASPNETCORE_ENVIRONMENT=Development \
    AZURE_FUNCTIONS_ENVIRONMENT=Development

# 启动dotnet watch监听代码变更，自动重编译后触发函数宿主重载
ENTRYPOINT ["dotnet", "watch", "msbuild", "/t:RunFunctions"]

注意：移除错误的AzureWebJobsScriptRoot配置，C#类库型函数的运行时会自动扫描当前工作目录下的编译产物，无需手动指定脚本根目录。

2. 调整docker-compose配置 #

version: '3.4'
services:
  func-test:
    image: func-test:dev
    build:
      context: ./FunctionApp1
      dockerfile: Dockerfile
    ports:
      - "8026:80"
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - AZURE_FUNCTIONS_ENVIRONMENT=Development
      - DOTNET_USE_POLLING_FILE_WATCHER=1
    volumes:
      - ./FunctionApp1:/src
      # 匿名卷挂载屏蔽容器内bin、obj目录，避免宿主机文件覆盖容器内构建缓存
      - /src/bin
      - /src/obj

3. 验证运行 #

执行docker-compose up --build重新构建启动容器，启动完成后日志会输出如下路由映射信息，代表函数加载正常：

Initializing function HTTP routes
Mapped function route 'api/Function1' [get,post]
Host initialized
Job host started

此时访问http://localhost:8026/api/Function1?name=test可正常拿到接口返回。修改本地任意函数代码保存后，容器内会自动触发重编译、重载函数进程，无需重启容器即可看到变更效果，达到和dotnet watch、nodemon一致的热更新体验。

• C#类库型Azure Function是编译型运行模式，不能直接在源码目录执行func host start启动，必须先通过dotnet build生成编译产物，否则运行时扫不到任何函数定义。
• 容器卷挂载时必须排除bin、obj目录，否则容器内dotnet restore生成的依赖缓存会被宿主机的空目录覆盖，导致构建失败、依赖缺失。
• 容器场景下必须开启DOTNET_USE_POLLING_FILE_WATCHER=1，否则默认的文件系统监听无法感知宿主机挂载目录下的文件变更，热更新会失效。

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