通过Terraform部署Azure Functions v2 Python后未在门户显示求助

• 检查Terraform函数应用的部署配置完整性
  确认Terraform的azurerm_function_app资源是否包含代码部署逻辑：

  • 若用本地zip包部署，需配置source_code_zip_path指向包含完整函数代码的压缩包，确保压缩包包含host.json、函数目录（含__init__.py和function.json）；
  • 验证app_settings中是否配置了必要参数：FUNCTIONS_WORKER_RUNTIME=python、FUNCTIONS_EXTENSION_VERSION=~2（对应Functions v2 runtime）、Blob触发器所需的存储连接字符串（如AzureWebJobsStorage，需与function.json中的connection字段匹配）；
  • 若未显式配置代码部署，可补充azurerm_function_app_deployment资源，通过zip包或存储账户部署代码。

• 验证函数代码结构与绑定配置
  确保代码符合Python Functions的规范：

  • 根目录存在host.json，指定version: "2.0"及正确的扩展包版本；
  • Blob触发器函数目录下的function.json需正确配置绑定：

    {
      "scriptFile": "__init__.py",
      "bindings": [
        {
          "name": "myblob",
          "type": "blobTrigger",
          "direction": "in",
          "path": "your-container/{name}",
          "connection": "AzureWebJobsStorage"
        }
      ]
    }
    

  • 确认__init__.py中存在对应的函数入口（如def main(myblob: func.InputStream):）。

• 确认代码是否成功上传至函数应用
  登录Azure门户进入函数应用的高级工具(Kudu)，通过Debug console查看site/wwwroot目录，检查是否存在完整的代码文件。若目录为空或文件缺失，说明Terraform的代码部署步骤未生效，需排查压缩包路径、权限或Terraform资源配置问题。

• 排查门户显示延迟或同步问题
  部分情况下门户存在显示延迟，可等待5-10分钟后刷新页面；也可通过Azure CLI命令验证函数是否存在：

  az functionapp function list --name <你的函数应用名> --resource-group <资源组名>
  

  若CLI能查询到函数，说明仅为门户显示问题，清除浏览器缓存或切换浏览器重试即可。

• 查看日志定位错误

  • 检查Terraform执行日志，确认代码部署阶段无报错；
  • 在Azure门户函数应用的监控->日志中，查看函数初始化、绑定相关的错误信息（如存储连接字符串无效、权限不足）；
  • 前往Kudu的Log Files/Application/Functions/Host目录，查看host日志，其中会记录函数加载失败的具体原因。

• 对比VS Code与Terraform部署的差异
  VS Code部署会自动处理诸多配置（如设置WEBSITE_RUN_FROM_PACKAGE=1、指定Python版本），可将VS Code部署后的函数应用配置（应用设置、代码结构）与Terraform部署的版本对比，补全缺失的参数或配置。

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