Azure Functions本地调试自定义模块缺失问题及添加方法咨询

问题描述 #

在Visual Studio Code中调试Azure Functions定时触发函数时，遇到错误：

No module named {My custom module Name}. Please check the requirements.txt file for the missing module.

错误指向自定义模块的导入语句，代码尝试导入同项目下的import2SQL_Life和GetFromAPI模块但失败，期望正常调用自定义模块，需解决该问题、明确自定义模块与requirements.txt的关系，以及确认Azure Functions是否支持自定义模块。

示例代码：

import datetime
import logging
import import2SQL_Life as ISQL
import GetFromAPI as GA
import azure.functions as func


def main(mytimer: func.TimerRequest) -> None:
    company=GA.GetRefrenceCompanies() 
    ISQL.insertCompaniesSQL(company)
    print("done")
    utc_timestamp = datetime.datetime.utcnow().replace(
        tzinfo=datetime.timezone.utc).isoformat()

    if mytimer.past_due:
        logging.info('The timer is past due!')

    logging.info('Python timer trigger function ran at %s', utc_timestamp)

1. Azure Functions对自定义模块的支持 #

完全支持Python自定义模块，只要目录结构和导入方式符合Python模块规范，就能正常调用。

2. 修复"No module named..."错误 #

该错误核心是Python解释器无法定位自定义模块，按以下步骤排查：

• 核对目录结构：确保自定义模块文件（import2SQL_Life.py、GetFromAPI.py）和函数主文件（如__init__.py）处于同一层级；若模块在子目录中，需在子目录内添加空的__init__.py文件将其标记为Python包，导入时使用相对路径或完整包路径。
• 检查导入语句：同层级模块直接用import 模块名即可，注意模块名不要与Python内置模块、第三方包重名。
• 统一运行环境：在VS Code左下角切换到与Azure Functions一致的Python虚拟环境，避免因环境不一致导致模块无法识别。
• 清理缓存重启：删除项目下的.venv虚拟环境目录和.vscode配置目录，重新创建虚拟环境后重启VS Code，清除缓存异常。

3. 自定义模块与requirements.txt的关系 #

自定义模块不需要添加到requirements.txt中。该文件仅用于声明项目依赖的第三方Python包（如azure-functions、requests等），自定义模块属于项目代码的一部分，无需在此声明。错误提示中要求检查requirements.txt只是系统通用提示，并非针对自定义模块。

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