Python v2 Azure Functions正确文件夹结构及共享代码导入问题

1. 全局导入导致函数无法识别
   Azure Functions启动时会扫描并加载函数模块，全局代码（包括顶部的导入语句）会在函数初始化阶段执行。此时如果shared_code/helper.py依赖requests，但运行环境中该依赖未完成加载，或者shared_code目录未被添加到Python的搜索路径，会触发导入失败，Function Host直接判定该函数无效，因此不会在控制台显示。

2. 内部导入触发500错误
   虽然requirements.txt声明了requests，但部署时大概率是这两个问题：要么依赖未被正确安装到函数运行环境，要么shared_code的模块路径配置缺失，导致helper.py中的import requests找不到已安装的依赖包。

1. 确认标准项目结构 #

Python v2 Azure Functions的标准结构需如下：

你的函数应用根目录/
├── requirements.txt
├── host.json
├── local.settings.json（本地开发用，无需部署）
├── shared_code/
│   ├── __init__.py（空白文件即可）
│   └── helper.py
└── 具体函数目录/
    ├── function.json
    └── __init__.py（函数入口文件）

2. 添加Python搜索路径（关键） #

在函数入口文件（比如具体函数目录/__init__.py）的最顶部添加代码，将shared_code所在的上级目录加入Python搜索路径，确保模块能被正确识别：

import sys
import os
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))

3. 规范导入方式 #

把from shared_code.helper import debug_print放回函数入口文件的顶部（全局导入即可），无需放在main函数内部。同时检查helper.py中的import requests是否有拼写错误。

4. 确保依赖正确部署 #

• 把requirements.txt放在项目根目录，内容明确声明requests（比如requests>=2.31.0）；
• 本地部署用官方命令：func azure functionapp publish <你的函数应用名>，该命令会自动安装requirements.txt中的依赖；
• 若用CI/CD（如GitHub Actions）部署，必须添加依赖安装步骤，比如pip install -r requirements.txt。

5. 本地验证后再部署 #

先在本地执行func start，确认函数能正常启动、调用，无导入错误。本地运行正常后再部署到Azure，避免本地与云端环境不一致的问题。

• 检查Azure Function App的运行时Python版本，需与本地开发环境一致；
• 登录Azure门户，在“监测”->“日志”中查看详细错误信息，确认依赖安装状态；
• 若本地使用虚拟环境，部署时不要上传虚拟环境目录，避免依赖路径冲突。

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