如何调试Python Azure Function Zip部署后无函数显示问题？

通过Zip部署Python应用为Azure Functions App，仅将src文件夹压缩为部署包（本地func start可正常运行），执行部署命令后显示成功，但Function App GUI中无任何函数显示：

az functionapp deployment source config-zip --src ./dist/dependency-webhook-api.zip --resource-group ${AZURE_APP_RG} --name ${AZURE_APP_NAME} --subscription ${AZURE_APP_SUBSCRIPTION} --timeout 180

项目结构：

src/
├── lib
├── modules
    ├── __init__.py
    └── trivy/
        ├── __init__.py
        ├── fetch_release.py
        ├── send_notification.py
        ├── main.py
        └── adaptive_card_template.json
├── __init.py__
├── .funcignore
├── function_app.py
├── host.json
├── requirements.txt
└── local.settings.json
pyproject.toml
poetry.lock

关键文件内容（function_app.py、host.json、modules/trivy/main.py、requirements.txt）已提供。添加--build-remote true参数重新部署后仍未解决。

1. 修正部署包基础问题 #

• 解压部署包，确认根目录直接包含function_app.py、host.json、requirements.txt及modules、lib文件夹，无多余嵌套层级（避免包内根目录为src/）。
• 修正src下的模块文件命名：将__init.py__改为__init__.py，拼写错误会导致Python无法识别为合法模块，直接影响Blueprint导入。

2. 查看运行时启动日志 #

• 登录Azure Portal进入目标Function App，导航至监控 > 日志，开启日志流，重点查看：
  • 模块导入错误（如from modules.trivy.main import trivy_module失败提示）
  • 依赖缺失报错
• 使用CLI实时查看日志：

  az functionapp log tail --resource-group ${AZURE_APP_RG} --name ${AZURE_APP_NAME}
  

3. 验证依赖安装状态 #

• 未使用--build-remote true时，Azure不会自动安装依赖，需确保部署包内已包含lib/site-packages目录，且本地通过pip install -r requirements.txt -t ./lib/site-packages完成依赖预安装后再打包。
• 使用--build-remote true时，进入Function App的部署中心 > 日志，查看远程构建过程：
  • 确认requirements.txt中的依赖全部安装成功
  • 核对Azure Function App配置的Python运行时版本（需为3.11+，与requirements.txt版本限制匹配）

4. 检查Blueprint注册逻辑 #

• 确认modules/trivy/__init__.py为空或正确导出trivy_module，确保Python能识别该Blueprint模块。
• 在function_app.py中添加启动日志验证注册流程：

  import logging
  logging.info("Starting to register trivy_module blueprint")
  app.register_functions(trivy_module)
  logging.info("trivy_module blueprint registered successfully")
  

• 检查Timer Trigger定义：确认schedule格式合法，run_on_startup=True是否触发过函数，通过日志验证执行记录。

5. 手动触发函数测试 #

• 使用CLI手动触发Timer函数，验证函数是否被正确识别：

  az functionapp invoke --resource-group ${AZURE_APP_RG} --name ${AZURE_APP_NAME} --function-name trivy_module
  

• 根据触发返回的错误信息，定位具体问题。

6. 检查Function App配置 #

• 确认运行时版本：在配置 > 常规设置中查看Python版本为3.11+，与requirements.txt版本限制一致。
• 检查WEBSITE_RUN_FROM_PACKAGE设置：若启用该选项，需确保部署包为标准Zip格式，且内容完整无损坏。

内容的提问来源于stack exchange，提问作者Vanja Stojanović