Azure PowerShell函数本地正常运行，部署至Azure后报错求助

核心排查方向及解决方案 #

1. 启用托管依赖配置 #

• 登录Azure门户，进入目标函数应用的配置 > 应用程序设置
• 查找FUNCTIONS_POWERSHELL_MANAGED_DEPENDENCIES项，确保值设置为1（若不存在则新建该设置）
• 保存设置后重启函数应用，托管依赖会自动从PowerShell Gallery下载指定模块

2. 确认requirements.psd1的位置与格式 #

• 该文件必须放在函数应用的根目录（wwwroot文件夹下），不能放在单个函数的子文件夹（如Func_Sample_1）中
• 检查文件语法：确保使用英文单引号，键值对格式正确，无多余符号。建议指定具体版本而非通配符，避免拉取不兼容的最新版本，示例如下：

@{
    'Az.Accounts' = '2.13.0'
    'Az.Resources' = '6.10.0'
    'SqlServer' = '22.1.1'
}

3. 验证PowerShell版本兼容性 #

• 进入函数应用的配置 > 常规设置，确认运行时堆栈为PowerShell 7.x（推荐7.2或7.4）
• Az模块和SqlServer模块仅支持PowerShell 6.2+，若使用PowerShell 5.1必然出现模块找不到的错误

4. 手动部署模块的正确姿势 #

• 若手动上传模块，需先将FUNCTIONS_POWERSHELL_MANAGED_DEPENDENCIES设为0（关闭托管依赖），避免自动下载覆盖手动模块
• 模块文件夹结构必须正确：将模块放在wwwroot/Modules/<模块名>/<版本号>下，例如：

  wwwroot/
  ├─ Modules/
  │  ├─ Az.Accounts/
  │  │  └─ 2.13.0/
  │  │     ├─ Az.Accounts.psd1
  │  │     └─ ...（其他模块文件）
  │  └─ SqlServer/
  │     └─ 22.1.1/
  │        ├─ SqlServer.psd1
  │        └─ ...
  └─ Func_Sample_1/
     └─ run.ps1
  

5. 排查模块下载失败原因 #

• 查看函数应用的日志流，搜索ManagedDependencies相关日志，确认是否存在网络访问问题（如函数应用无法连接PowerShell Gallery）
• 若函数应用处于内网环境，需配置代理或设置私有模块源，确保能访问模块仓库

6. 重新部署函数应用 #

• 使用VS Code重新部署，确保requirements.psd1被正确上传至wwwroot目录
• 或使用Azure CLI命令强制同步所有文件：

func azure functionapp publish <你的函数应用名称> --publish-local-settings

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