AWS Lambda .NetCore环境下PowerShell脚本无法导入Azure AZ模块问题

问题根因 #

该问题核心是AWS Lambda运行环境的路径规则、依赖环境和本地开发环境不一致，导致Az模块未被正确导入，进而无法识别模块下的命令，具体常见诱因如下：

• 硬编码的模块路径和Lambda实际部署路径不匹配
• PowerShell实例的PSModulePath搜索路径未包含自定义模块存放目录，模块导入时找不到嵌套依赖
• 部署包未完整包含Az模块的跨平台版本依赖文件
• 未捕获PowerShell的错误流，无法感知Import-Module步骤的实际报错

修复方案 #

1. 动态获取模块路径，避免硬编码 #

将Az模块文件夹放在项目根目录的modules文件夹下，将文件夹内所有文件的「复制到输出目录」属性设置为「如果较新则复制」，代码中动态拼接Lambda运行时的模块绝对路径：

public void FunctionHandler(Input Input, ILambdaContext context)
{
    try
    {
        using (PowerShell Script = PowerShell.Create())
        {               
            // 动态获取自定义模块目录路径
            string customModuleDir = Path.Combine(AppContext.BaseDirectory, "modules");
            // 把自定义目录加到PSModulePath最前面，解决依赖搜索问题
            Script.AddScript($@"$env:PSModulePath = @('{customModuleDir}', $env:PSModulePath) -join [System.IO.Path]::PathSeparator");
            // 显式导入Az.Accounts模块
            Script.AddScript(@"Import-Module Az.Accounts");
            // 导入其他需要的Az子模块，按需导入减少冷启动时间
            // Script.AddScript(@"Import-Module Az.Compute");
            
            string script = "你的实际PowerShell脚本内容";
            Script.AddScript(script);
            
            var result = Script.Invoke();
            
            // 捕获PowerShell运行错误，排查导入失败原因
            if (Script.HadErrors)
            {
                foreach (var err in Script.Streams.Error)
                {
                    Console.WriteLine($"PowerShell错误：{err.Exception.Message}，堆栈：{err.ScriptStackTrace}");
                }
            }
            
            foreach (var a in result)
            {
                Console.WriteLine(a.ToString());
            }
        }
    }
    catch (Exception e)
    {
        Console.WriteLine($"业务错误：{e}");
    }
}

2. 确保Az模块版本兼容 #

• 使用支持PowerShell 7+、适配Linux环境的跨平台Az模块，最低建议Az.Accounts版本≥2.10.0，避免Windows专属模块在Lambda Linux环境下无法加载
• 不要使用从本地Windows PowerShell（5.1及以下）目录拷贝的模块文件，建议通过Install-Module -Name Az.Accounts -Scope CurrentUser -Force在PowerShell 7环境下安装后再拷贝到项目modules目录

3. 验证部署包完整性 #

发布Lambda部署包时，确认modules目录下的所有Az模块文件都被正确打包到部署包中，没有遗漏的dll、psd1、psm1文件。

额外建议 #

• 优先使用AWS Lambda OIDC身份提供商对接Azure AD，代替Connect-AzAccount硬编码服务主体密钥，避免凭证泄露风险
• 按需导入对应业务需要的Az子模块，不要全量导入整个Az大模块，大幅降低冷启动耗时和内存占用

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