Azure Functions Python V2使用自定义模块遇异常问题咨询

一、共享代码导入失败的解决步骤 #

1. 确认目录结构正确性 #

确保项目目录符合V2规范，shared_code必须作为Python包存在：

你的函数应用根目录/
├── function_app.py
├── shared_code/
│   ├── __init__.py  # 必须存在，可为空文件
│   └── helper_functions.py
└── requirements.txt

__init__.py是Python识别包的必要文件，缺失会导致无法导入模块。

2. 修复导入路径或显式添加根目录到sys.path #

V2默认会将应用根目录加入Python路径，但部分场景下可能需要显式声明。在function_app.py开头添加以下代码：

import sys
from pathlib import Path
# 将当前文件所在目录（即应用根目录）添加到Python路径
sys.path.append(str(Path(__file__).parent))

# 之后执行导入
from shared_code import helper_functions

如果只需使用helper_functions.py中的特定函数，也可以直接导入：

from shared_code.helper_functions import 目标函数名

3. 检查部署排除规则 #

查看项目根目录下的.funcignore和.gitignore文件，确保没有将shared_code/加入排除列表。若存在相关规则，删除后重新部署。

4. 本地测试定位错误 #

在本地执行func start启动函数，查看控制台日志。如果出现ModuleNotFoundError，说明是本地代码/目录问题；如果本地运行正常但Azure门户中函数消失，大概率是部署时文件未上传完整，重新执行func deploy同步所有文件。

二、关于蓝图的疑问 #

你的理解完全正确。Azure Functions Python V2中的蓝图（Blueprints）作用是对多个函数进行分组管理，比如将同业务域的函数归到同一个蓝图下，统一配置路由前缀、中间件等，并非用于解决共享代码的导入问题。共享代码应该通过Python包/模块的方式导入，和常规Python项目的做法一致。

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