Azure Functions部署问题：本地自定义Python包云端无法加载

问题根源 #

云端部署环境不支持pip install -e的可编辑安装模式，或部署时自定义包的结构未被正确打包，导致函数加载失败。

可行解决方案 #

方案1：打包自定义包为Wheel文件部署 #

1. 本地构建Wheel包：
   进入submodules/my-custom-libs/Source/my-custom-lib目录，执行：

   python setup.py bdist_wheel
   

   生成的Wheel文件会在该目录的dist子文件夹中（例如my_custom_lib-0.1.0-py3-none-any.whl）。

2. 调整项目配置：

   • 将生成的Wheel文件复制到Azure Function项目根目录
   • 修改requirements.txt，替换原有的可编辑安装行：

     ./my_custom_lib-0.1.0-py3-none-any.whl
     azure-functions
     

   • 检查.funcignore文件，确保没有排除Wheel文件（如果有类似dist/的规则，需移除或修改）

3. 重新部署函数：
   使用Azure Core Tools执行发布命令：

   func azure functionapp publish my_function_app
   

方案2：直接添加自定义包路径到Python环境 #

无需通过pip安装，直接在代码中指定自定义包的路径：

1. 修改function_app.py，在导入自定义模块前添加路径配置：

   import logging
   import azure.functions as func
   import sys
   from pathlib import Path
   
   # 添加自定义包路径到Python搜索路径
   sys.path.append(str(Path(__file__).parent / "submodules" / "my-custom-libs" / "Source" / "my-custom-lib"))
   
   from util.util import my_custom_function
   
   # 后续函数代码保持不变
   

2. 清理依赖配置：
   删除requirements.txt中关于自定义包的可编辑安装行，仅保留：

   azure-functions
   

3. 检查.funcignore：
   确保没有排除submodules文件夹，避免部署时丢失自定义包源码。

4. 重新部署函数即可。

方案3：本地构建完整环境后部署 #

确保本地虚拟环境包含所有依赖，再打包整个环境上传：

1. 激活本地虚拟环境：

   • Windows：.venv\Scripts\activate
   • Linux/macOS：source .venv/bin/activate

2. 安装所有依赖：

   pip install -e ./submodules/my-custom-libs/Source/my-custom-lib azure-functions
   

3. 本地构建并发布：

   func azure functionapp publish my_function_app --build local --publish-local-settings -i
   

额外检查项 #

• 确认云端函数应用的Python版本与本地开发环境一致（Azure Portal -> 函数应用 -> 配置 -> 常规设置）
• 查看云端日志流（Azure Portal -> 函数应用 -> 监控 -> 日志流），排查是否有隐藏的依赖安装或模块导入错误
• 确保.funcignore中没有误排除submodules、Wheel文件等必要资源

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