Python Azure Function部署后端点不可见问题求助

以下是针对该问题的具体排查步骤：

• 验证部署包结构
  确保function_app.py、host.json和requirements.txt直接位于site/wwwroot根目录下，无嵌套子文件夹结构。可通过Kudu控制台（https://<your-function-app>.scm.azurewebsites.net/）查看目录结构，若文件在子目录，需调整打包逻辑，将函数代码所在文件夹设为打包根目录。

• 检查运行时索引日志
  在Azure门户的「监测」>「日志」中，搜索WorkerIndexer或FunctionDiscovery关键词，查看是否存在函数索引失败的报错。常见问题包括函数文件加载失败（语法错误、依赖缺失）、索引器未找到有效函数定义等。

• 确认依赖安装状态
  通过Kudu控制台进入site/wwwroot目录，执行pip list命令，核对requirements.txt中的依赖是否全部安装完成。若load_dataframe()依赖的包未正确安装，会导致函数初始化失败，无法被索引。同时查看部署日志，确认pip install过程是否有报错。

• 重启函数应用
  手动重启函数应用（门户>概述>重启按钮，或执行命令az functionapp restart --resource-group <myRg> -n <myFunctionName>），确保环境变量和配置变更生效。

• 校验host.json配置
  确认host.json符合Python v4 runtime的要求，核心配置示例如下：

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

  检查是否存在语法错误或禁用函数索引的配置项。

• 测试手动部署
  将本地生成的部署包（zip文件）通过Azure门户的「部署中心」>「高级选项」手动上传，观察是否能识别到函数。若手动部署成功，说明Azure DevOps流水线的打包过程存在问题（如路径错误、包含无关文件），需调整流水线的Archive任务配置，确保打包根目录正确。

• 验证代码与运行时匹配
  确认本地开发的Python版本（3.10）与Azure上配置的Runtime版本完全一致，可在Kudu控制台的「环境」>「应用设置」中查看PYTHON_VERSION的值，确保为3.10.x。同时检查function_app.py中的装饰器是否正确，无拼写错误。

• 手动触发测试
  尝试直接访问函数端点https://<your-function-app>.azurewebsites.net/api/match-names，根据返回错误码排查：

  • 404：函数未被索引，回到前述步骤检查
  • 500：函数执行报错，查看应用日志（门户>监测>日志）获取具体错误信息

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