Azure QueueTrigger函数应用运行时版本更新失败求助

核心原因 #

你的QueueTrigger函数显示custom(~4)，说明运行时并非Azure官方托管的标准版本，而是基于自定义Docker镜像的运行环境。HTTP Trigger无custom标识，应该是采用了Azure托管计划（而非Docker部署），两者部署方式的差异导致版本标识不同，这也是更新警告持续出现的关键。

具体修复步骤 #

1. 替换为官方Azure Functions Docker基础镜像 #

Docker部署必须使用微软官方的Azure Functions镜像，避免自定义非官方镜像导致运行时被标记为custom：

• .NET环境使用：mcr.microsoft.com/azure-functions/dotnet:4
• Python环境根据版本选择，例如mcr.microsoft.com/azure-functions/python:4-python3.11
• 其他语言同理，确保镜像标签对应4（匹配~4运行时）

修改Dockerfile中的基础镜像声明：

FROM mcr.microsoft.com/azure-functions/dotnet:4

2. 确保环境变量正确传递到容器 #

Docker部署时，FUNCTIONS_EXTENSION_VERSION需通过运行参数或配置文件明确传递，避免被镜像内默认值覆盖：

• 直接运行容器时添加参数：

  docker run -e FUNCTIONS_EXTENSION_VERSION=~4 [其他参数]
  

• 使用docker-compose时，在environment节点配置：

  environment:
    - FUNCTIONS_EXTENSION_VERSION=~4
  

3. 修正host.json的extensionBundle配置 #

host.json中的扩展包版本范围必须匹配~4运行时，配置如下：

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

保持版本范围格式，不要指定过于具体的版本，确保兼容~4运行时的最新扩展包。

4. 重新构建并部署镜像 #

修改完成后，重新构建镜像并推送到容器注册表，再更新Azure函数应用的部署：

docker build -t your-image-tag:v1 .
docker push your-image-tag:v1

在Azure门户的函数应用部署中心触发重新部署。

5. 验证版本状态 #

部署完成后，前往Azure门户函数应用的「配置」->「常规设置」查看运行时版本，此时应显示~4而非custom(~4)，更新警告会自动消失。

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