Azure Function导入自定义Python包报ModuleNotFoundError咨询

可行放置路径与配置方式 #

• 方案1：直接放置在函数应用根目录（零代码修改，最简便）
  将完整的pythonpackage包文件夹（文件夹内必须包含__init__.py空文件作为Python包标识）放在和host.json、函数入口文件（function_app.py或老版本函数目录下的__init__.py）同级的项目根目录即可。
  正确目录结构参考：

  函数项目根目录/
  ├── host.json
  ├── local.settings.json
  ├── requirements.txt
  ├── function_app.py  # 写导入逻辑的函数入口文件
  └── pythonpackage/
      ├── __init__.py
      └── featureimpl.py
  

  该结构下你原有导入代码from pythonpackage.featureimpl import feature as f不需要任何修改即可正常运行。

• 方案2：放置在自定义子目录（适合统一管理多份共享代码）
  如果你希望把所有自定义包统一放在比如shared_code这类单独的子文件夹下，不需要修改导入语句，只需要在函数入口文件的最顶部添加代码，将自定义目录加入Python模块检索路径：

  import sys
  import os
  # 拼接自定义包目录的绝对路径，Azure Function运行时默认工作目录为项目根目录
  sys.path.append(os.path.join(os.path.dirname(__file__), 'shared_code'))
  
  # 原有导入代码放在路径配置之后
  import azure.functions as func
  from pythonpackage.featureimpl import feature as f
  

  对应目录结构参考：

  函数项目根目录/
  ├── function_app.py
  └── shared_code/
      └── pythonpackage/
          ├── __init__.py
          └── featureimpl.py
  

• 方案3：打包为whl安装（生产环境多函数复用推荐）
  如果自定义包需要在多个函数应用间复用，可以将包打包为.whl格式安装包，放在项目目录下，在requirements.txt中添加本地包引用：

  # requirements.txt 新增行
  ./local_wheels/pythonpackage-0.1.0-py3-none-any.whl
  

  部署时Azure会自动将该包安装到Python运行时的site-packages目录，不需要额外配置路径。

注意：所有方案都要求pythonpackage文件夹内必须存在__init__.py文件（可以是空文件），否则Python无法将文件夹识别为合法包，依然会抛出模块不存在的报错。

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