发布Azure Functions v2后无触发器/函数加载问题求助

问题分析与解决方案 #

可能原因及对应解决步骤： #

• 依赖包未正确安装

  1. 确认requirements.txt包含所有必要依赖：在本地虚拟环境中执行pip freeze > requirements.txt，确保azure-functions、py_pdf（注意包名是否匹配PyPI标准名称）及其他依赖均被写入。
  2. 检查Azure部署日志：查看发布过程中是否有依赖安装失败提示，若因网络问题导致包无法下载，可改用Zip部署包并提前在本地完成依赖构建。

• 运行时版本不匹配
  登录Azure门户，进入函数应用的配置 > 常规设置，确认Python运行时版本与本地开发环境完全一致（例如本地用Python 3.10，云端需同步设置为3.10）。

• 函数加载错误（导入失败）
  查看函数应用的日志流，搜索ImportError或ModuleNotFoundError：

  • 若提示找不到py_pdf模块：如果是自定义模块，需确保模块文件夹与__init__.py同级且被一同发布；如果是第三方库，确认requirements.txt中的包名拼写无误。

• 项目结构或部署参数问题

  1. 确认项目结构符合Azure Functions V2规范：函数代码放在根目录的__init__.py中，host.json、requirements.txt需处于根目录层级。
  2. 检查.funcignore文件，避免误排除__init__.py、自定义模块文件夹等必要文件。
  3. 重新部署时添加--build remote参数：执行func azure functionapp publish <app-name> --build remote，强制Azure端重新构建依赖，规避本地与云端环境差异导致的兼容问题。

• 扩展包兼容性问题
  当前host.json中extensionBundle版本为[4.*, 5.0.0)，可尝试固定到具体稳定版本（例如"4.15.0"），避免自动升级到存在兼容问题的版本，修改后重新发布。

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