Azure Functions中PowerShell模块自动安装异常：Az正常但Microsoft.Graph失败

问题原因 #

• 模块体积与依赖复杂度：Microsoft.Graph模块包含数十个子模块，整体安装包体积和依赖数量远大于Az模块，Azure Function默认的安装超时窗口（约5分钟）不足以完成全量安装，导致超时中断。
• 网络访问限制：Azure Function运行环境的出站网络可能对PowerShell Gallery存在访问限制，大文件下载时容易出现丢包、连接中断，引发安装失败。
• 官方优化差异：Az模块是Azure官方针对Function环境优化过的模块，在requirements.psd1的自动安装流程中有预缓存、分批次安装等特殊处理，而Microsoft.Graph未适配该优化逻辑，直接全量安装易出问题。

解决建议 #

• 按需安装子模块：避免直接指定Microsoft.Graph全量模块，仅配置实际业务用到的子模块，大幅减少下载量和安装时间。例如在requirements.psd1中添加：

  @{
      # 仅安装所需子模块
      'Microsoft.Graph.Users' = '2.15.0'
      'Microsoft.Graph.Groups' = '2.15.0'
  }
  

• 延长安装超时时间：在Function App的应用设置中添加或调整以下配置：
  • 设置FUNCTIONS_POWERSHELL_TIMEOUT为更大值（如300，单位秒，注意不超过平台上限）
  • 启用WEBSITE_RUN_FROM_PACKAGE = 1，让Function从本地包运行，减少网络依赖
• 自定义安装脚本：在Function的启动逻辑中手动执行模块安装，通过参数强制跳过检查并延长超时。例如在run.ps1开头添加：

  $ErrorActionPreference = 'Stop'
  # 安装指定版本的目标子模块
  Install-Module -Name Microsoft.Graph.Users -RequiredVersion 2.15.0 -Force -SkipPublisherCheck -AllowClobber -TimeoutSec 300
  

• 检查网络连通性：如果Function App配置了VNet集成或防火墙规则，确保出站流量允许访问https://www.powershellgallery.com，必要时添加代理配置。
• 离线包集成部署：提前在本地下载好所需的Microsoft.Graph子模块及依赖，将模块文件夹打包到Function部署包的Modules目录下，配合requirements.psd1指定版本，实现离线加载。

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