Azure Function App中Microsoft Graph模块加载失败求助

可能的解决方案 #

1. 检查Requirements.psd1的格式正确性 #

Azure Function的Requirements.psd1必须是标准的PowerShell哈希表格式，确保你的配置包裹在@{ }内，示例：

@{
    'Microsoft.Graph' = '2.1.0'
    'Microsoft.Graph.Authentication' = '2.1.0'
}

格式错误会导致Azure托管依赖机制无法识别并加载模块。

2. 确认托管依赖配置与模块完整性 #

• 在Azure Portal进入你的Function App，前往配置 > 常规设置，确保启用托管依赖已开启。
• 通过Kudu工具（Function App概述页点击“高级工具”，启动后进入Debug console > PowerShell），检查路径site\wwwroot\.powershell\Modules下是否存在Microsoft.Graph.Authentication\2.1.0目录，且文件完整。若模块文件损坏或缺失，删除该目录后重启Function App，触发重新下载依赖。

3. 验证PowerShell运行时版本兼容性 #

Microsoft Graph 2.1.0模块要求PowerShell 7.0及以上版本：

• 在Function App的配置 > 常规设置中，确认PowerShell版本设置为7.x（如7.2、7.3），避免使用PowerShell 5.1，该版本与新版Graph模块存在兼容性问题。

4. 显式指定模块路径导入 #

若托管依赖的模块路径识别异常，可在run.ps1中指定绝对路径导入模块：

$modulePath = Join-Path $env:HOME "site\wwwroot\.powershell\Modules\Microsoft.Graph.Authentication\2.1.0"
Import-Module $modulePath -Force -ErrorAction Stop

5. 获取模块加载的详细错误信息 #

添加错误捕获代码，在日志中查看具体失败原因：

Import-Module Microsoft.Graph.Authentication -ErrorVariable importErr -ErrorAction SilentlyContinue
if ($importErr) {
    Write-Error "模块加载详细错误: $($importErr | Out-String)"
}

前往Function App的监测 > 日志查看输出的错误详情，排查是否存在依赖模块缺失、文件损坏等问题。

6. 尝试调整模块版本 #

部分版本的Microsoft Graph模块与Azure Function运行时存在兼容性问题，可尝试修改Requirements.psd1中的版本号（如改为2.0.0或2.2.0），重启Function App后测试。

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