Azure Functions运行报错：找不到__app__.appname.error_codes模块

排查步骤与解决方案 #

1. 确认部署文件完整性 #

• 登录Azure Portal进入目标Function App，打开高级工具(Kudu)，通过调试控制台导航到/home/site/wwwroot/hubs_watchtower_data/目录，检查是否存在error_codes.py文件。如果缺失，说明部署过程中该文件被遗漏。
• 排查本地的.gitignore或.deployment配置，确认没有排除error_codes.py这类文件；如果用Zip部署，检查压缩包内是否包含该文件。

2. 验证Python包结构 #

• 确保hubs_watchtower_data目录下存在空的__init__.py文件，让Python识别这是合法的包。
• 确认models.py中的from .error_codes import Error是正确的相对导入，且error_codes.py与models.py在同一目录下。

3. 检查部署配置与CI/CD流程 #

• 如果使用CI/CD工具（如GitHub Actions）部署，检查脚本是否完整包含所有Python文件，避免只打包特定目录或排除py文件的情况。
• 使用Azure Functions Core Tools重新部署时添加--force参数强制覆盖：func azure functionapp publish <你的函数应用名称> --force，规避缓存导致的文件缺失问题。

4. 对齐本地与Azure的Python版本 #

• 栈信息显示Azure使用Python 3.10，确认本地开发环境也是Python 3.10，避免版本差异引发的导入逻辑不一致。

内容的提问来源于stack exchange，提问作者Oscar Montañes