Python运行时Azure Functions部署导入H2O模块报错排查

本问题关联此前发布的Stack Overflow问题《Azure Functions with python runtime. H2O Module not available error》。此前在社区用户帮助下已解决本地环境的相关问题，但将源码部署到Azure Functions、导入H2O模块时再次触发异常。

函数应用配置 #

[ 
  {
    "name": "ENABLE_ORYX_BUILD",
    "value": "true",
    "slotSetting": false
  },
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "value": "~4",
    "slotSetting": false
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "value": "python",
    "slotSetting": false
  },
  {
    "name": "SCM_DO_BUILD_DURING_DEPLOYMENT",
    "value": "true",
    "slotSetting": false
  }
]

测试代码 #

import datetime
import logging

import h2o
import azure.functions as func

def main(mytimer: func.TimerRequest) -> None:
    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)

报错截图 #

核心原因 #

• H2O的Python包是Java服务的客户端封装，运行必须依赖Java运行时环境，Azure Functions Python默认基础镜像未预装JRE，导入h2o时找不到Java依赖就会抛出模块不可用错误
• 如果项目根目录requirements.txt没有固定h2o版本，Oryx自动构建时可能拉取和当前Azure Functions Python小版本不兼容的h2o发行版，出现依赖安装缺失
• Azure Functions消费计划默认开启32位运行环境，和绝大多数h2o发行版要求的64位运行环境存在兼容性冲突

解决步骤 #

• 固定依赖版本：在本地和Azure Functions运行版本完全一致的Python环境中安装项目依赖，执行pip freeze > requirements.txt，明确锁定h2o版本号，避免构建时拉取不兼容版本
• 切换64位运行环境：进入函数应用的「配置」-「常规设置」，将平台选项从32位修改为64位，同时新增应用设置WEBSITE_USE_PLACEHOLDER = 0，关闭默认预加载占位符环境，避免依赖加载冲突
• 补齐Java运行时依赖：
  • 若使用Linux消费计划，在项目根目录新建.deployment文件，写入内容[config] command = bash deploy.sh，再在同目录新建deploy.sh脚本，在脚本中完成apt源更新、安装OpenJDK 8/11、配置JAVA_HOME环境变量的逻辑，部署时Oryx会自动执行该脚本完成JRE安装
  • 若不想编写自定义构建脚本，可将函数托管计划从消费计划升级到Premium计划或者专用App Service计划，这类计划支持直接通过站点扩展安装OpenJDK，安装完成后在应用设置中配置好JAVA_HOME路径即可
• 清理缓存重新部署：清除之前部署残留的缓存文件，触发一次全新的完整构建部署，避免旧缓存依赖导致问题复现

优化提示：不要在函数全局作用域直接初始化h2o集群连接，建议增加懒加载逻辑，仅在第一次实际调用h2o能力时再做初始化，避免冷启动超时。

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