Azure Functions中导入自定义Python文件失败的解决方法咨询

我来帮你分析下这个导入问题，结合你用GitHub Actions部署的场景，咱们一步步排查解决：

一、先确认核心的文件结构 #

首先你的src目录结构必须是这样的，两个文件要同级存放：

src/
├── function_app.py
├── newconfig.py
└── requirements.txt

如果结构没问题，咱们再来看导入写法和部署环境的适配问题。

二、调整导入写法适配Azure Functions环境 #

Azure Functions的Python运行时会把函数入口文件（也就是function_app.py）所在的目录加入模块搜索路径，但有时候会因为部署或运行时的路径逻辑导致导入失败，你可以试试这两种写法：

1. 基础导入（优先尝试）
   保持你原来的import newconfig，先确认本地用func start测试是否正常——如果本地能跑，那大概率是部署时的路径问题；如果本地也报错，那就是导入逻辑的问题。
2. 相对导入写法
   如果基础导入不行，试试用相对导入（要求两个文件在同一目录下）：

   from . import newconfig
   

   之后你可以用newconfig.MyConfig来调用类。

三、确保部署时文件完整上传 #

你用GitHub Actions的package: src指定部署目录，要确认newconfig.py确实被包含在src目录里，没有被.gitignore或其他规则排除。可以在部署步骤前加一个验证步骤，检查文件是否存在：

- name: 验证src目录下的文件
  run: ls -la src/

把这个步骤加在Install dependencies之后、Download Azure Function publishing profile之前，这样能直观看到newconfig.py是否被正确检出。

四、兜底方案：手动添加模块搜索路径 #

如果上面的方法都没解决，你可以在function_app.py开头手动把当前目录加入Python的模块搜索路径，强制让运行时找到newconfig.py：

import sys
import os
# 把当前文件所在目录加入sys.path
sys.path.append(os.path.dirname(os.path.abspath(__file__)))

import azure.functions as func
import logging
import newconfig  # 现在应该能成功导入了

五、查看详细错误日志精准定位 #

如果还是报错，一定要去Azure Portal看具体的错误信息：

1. 进入你的Function App控制台
2. 左侧菜单选「函数」，点击你的定时器函数
3. 选「监测」→「日志」，查看完整的异常栈（比如是ModuleNotFoundError，还是导入后MyConfig类初始化的问题）
   根据具体错误再调整，比盲目试写法更高效。

六、进阶：组织成Python包（适合复杂项目） #

如果后续你的代码会扩展更多模块，可以把src整理成标准Python包结构：

src/
├── my_func_package/
│   ├── __init__.py
│   ├── function_app.py
│   └── newconfig.py
└── requirements.txt

然后导入写法改成from my_func_package import newconfig，同时在Azure Functions的配置里设置FUNCTIONS_WORKER_ROLE_PATH为my_func_package，这种结构更规范，也能避免导入路径问题。

备注：内容来源于stack exchange，提问作者mbieren