VS Code远程构建部署Azure Function App遇创建日期错误的问题

问题场景 #

在VS Code中通过Azure CLI部署基于Linux Consumption Plan的Python函数应用时，执行命令：

func azure functionapp publish --build remote

收到错误提示：

Remote build is a new feature added to function apps. Your function app does not support remote build as it was created before August 1st, 2019. Please use '--build local' or '--build-native-deps'

但该函数应用为2024年8月新建，理论上支持远程构建；尝试使用--build local参数部署仍触发相同错误，且应用非Docker架构，无法使用--build-native-deps参数。

可能触发原因 #

• 函数应用的运行时版本配置为旧版（如~1），导致CLI误判不支持远程构建
• Azure CLI或Functions Core Tools版本过旧，识别逻辑存在偏差
• VS Code的Azure Functions扩展缓存了旧的应用元数据，导致CLI读取错误信息
• 函数应用关联的存储账户配置异常，影响远程构建依赖的文件共享功能

解决步骤 #

1. 检查并更新函数应用运行时版本 #

• 登录Azure门户，进入目标Function App的配置 > 应用程序设置页面
• 找到FUNCTIONS_EXTENSION_VERSION项，确保值设置为~4（Python开发推荐版本），保存后重启应用

2. 更新Azure CLI与Functions Core Tools #

• 更新Azure CLI：

  az upgrade
  

• 更新Functions Core Tools（以v4版本为例）：
  • Windows：

    npm install -g azure-functions-core-tools@4
    

  • macOS/Linux（Homebrew）：

    brew install azure-functions-core-tools@4
    

3. 清除VS Code扩展缓存并重新关联应用 #

• 关闭VS Code，删除项目根目录下的.vscode文件夹（或仅删除其中与Azure Functions相关的配置）
• 重启VS Code，重新登录Azure账户，重新关联目标Function App

4. 验证远程构建支持状态 #

执行以下命令查看应用配置：

az functionapp config show --name <你的函数应用名称> --resource-group <你的资源组名称>

检查输出中siteConfig下的两个字段：

• linuxFxVersion：确认值为对应Python版本（如PYTHON|3.11）
• remoteBuildSupported：确认值为true

若remoteBuildSupported为false，建议重新创建函数应用（创建时确保选择正确的Python版本与Linux Consumption Plan）

5. 重新执行部署命令 #

切换到函数应用根目录，执行：

func azure functionapp publish <你的函数应用名称> --build remote

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