Azure Python函数应用部署后无法识别函数求助

核心排查方向及修复步骤 #

1. 确认部署包路径变量配置 #

新旧GitHub Action均使用${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}指定部署包路径，但该环境变量未在工作流中定义，可能导致部署路径错误。在deploy阶段添加环境变量定义：

env:
  AZURE_FUNCTIONAPP_PACKAGE_PATH: '.' # 根据解压后的代码结构调整，比如代码在子目录则设为./app

2. 优化WEBSITE_RUN_FROM_PACKAGE配置 #

当前新应用将该参数设为具体包路径，建议改为值1，让Azure自动管理包的存储与加载：

• 进入Azure Portal的新Function App配置页
• 在“应用程序设置”中找到WEBSITE_RUN_FROM_PACKAGE，修改值为1
• 保存配置并重启Function App

3. 验证部署包的代码结构 #

Python Azure Function App需符合特定结构才能被识别：

• 根目录需包含requirements.txt（若使用依赖）
• 每个函数对应一个子目录，目录内包含__init__.py和function.json（即使旧应用看似无此文件，大概率是VSCode自动生成后被忽略，需确认artifact中是否包含这些文件）
• 确保build步骤将所有函数相关文件打包进release.zip

4. 升级或调整部署Action版本 #

当前使用的Azure/functions-action@v1对Azure登录模式的支持存在局限，可尝试两种优化方式：

• 方式一：复用发布配置文件：在新Action中添加publish-profile参数，确保Secrets中存储了新应用的发布配置文件内容：

  - name: 'Deploy to Azure Functions'
    uses: Azure/functions-action@v1
    id: deploy-to-function
    with:
      app-name: 'newApp'
      slot-name: 'Production'
      package: ${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}
      publish-profile: ${{ secrets.AZUREAPPSERVICE_PUBLISHPROFILE_NEWAPP }}
      scm-do-build-during-deployment: true
      enable-oryx-build: true
  

• 方式二：升级至最新版Action：使用Azure/functions-action@v4，新版对Azure登录模式支持更完善：

  - name: 'Deploy to Azure Functions'
    uses: Azure/functions-action@v4
    id: deploy-to-function
    with:
      app-name: 'newApp'
      slot-name: 'Production'
      package: ${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}
      scm-do-build-during-deployment: true
      enable-oryx-build: true
  

5. 检查存储账户文件共享配置 #

确认WEBSITE_CONTENTSHARE对应的文件共享已在存储账户中创建，且WEBSITE_CONTENTAZUREFILECONNECTIONSTRING连接字符串正确无误。

额外排查手段 #

• 查看新Function App的应用日志（Azure Portal -> 监测 -> 日志），搜索函数加载失败的具体错误信息
• 确认新应用的FUNCTIONS_WORKER_RUNTIME设为python，且版本与旧应用完全一致（如python3.9）

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