PowerShell不同版本模块加载冲突：同名程序集已加载问题解决

问题场景 #

主脚本安装了MyModule的2.x和3.x版本，分别调用依赖对应版本的子脚本，但运行时触发错误：Assembly with same name is already loaded——原因是V2版本的程序集已加载到当前PowerShell进程的AppDomain中，且无法直接卸载，导致V3版本的脚本无法正常加载。

主脚本代码：

#Requires -PSEdition Core
# main logic
Install-Module -Name MyModule -RequiredVersion 2 -Scope CurrentUser -Force
Install-Module -Name MyModule -RequiredVersion 3 -Scope CurrentUser -Force
& UseV2.ps1
& UseV3.ps1

~/UseV2.ps1代码：

#Requires -Modules @{ ModuleName = 'MyModule'; RequiredVersion = '2' }
...

~/UseV3.ps1代码：

#Requires -Modules @{ ModuleName = 'MyModule'; RequiredVersion = '3' }
...

可行解决方案 #

1. 子进程隔离（推荐） #

PowerShell的AppDomain一旦加载托管程序集就无法卸载，因此将每个版本的脚本放在独立的子进程中运行，每个子进程拥有独立的AppDomain，程序集加载互不干扰。

修改主脚本如下：

#Requires -PSEdition Core
# 安装指定版本模块
Install-Module -Name MyModule -RequiredVersion 2 -Scope CurrentUser -Force
Install-Module -Name MyModule -RequiredVersion 3 -Scope CurrentUser -Force

# 启动独立子进程运行V2脚本
pwsh -File ~/UseV2.ps1

# 启动独立子进程运行V3脚本
pwsh -File ~/UseV3.ps1

2. 自定义AppDomain加载（进阶） #

若需在同一进程内处理，可通过C#代码创建独立AppDomain加载不同版本的程序集，执行完成后卸载AppDomain。

示例代码：

#Requires -PSEdition Core

# 定义跨AppDomain加载模块的C#辅助类
$loaderCode = @'
using System;
using System.Reflection;

public class CrossDomainLoader {
    public static void ExecuteModule(string moduleDllPath) {
        // 创建独立AppDomain
        AppDomain isolatedDomain = AppDomain.CreateDomain($"MyModuleDomain_{Guid.NewGuid()}");
        try {
            // 在新AppDomain中加载并执行模块逻辑
            isolatedDomain.DoCallBack(() => {
                Assembly.LoadFrom(moduleDllPath);
                // 此处可添加模块具体逻辑的执行代码
            });
        } finally {
            // 卸载AppDomain释放资源
            AppDomain.Unload(isolatedDomain);
        }
    }
}
'@

# 编译C#代码
Add-Type -TypeDefinition $loaderCode

# 获取两个版本模块的DLL路径
$v2ModulePath = (Get-Module -ListAvailable MyModule -RequiredVersion 2).Path
$v3ModulePath = (Get-Module -ListAvailable MyModule -RequiredVersion 3).Path

# 加载并执行V2版本模块
[CrossDomainLoader]::ExecuteModule($v2ModulePath)

# 加载并执行V3版本模块
[CrossDomainLoader]::ExecuteModule($v3ModulePath)

注意：部分PowerShell模块可能依赖主进程环境，此方法需针对具体模块测试兼容性。

3. 模块导入/卸载（仅适用于无程序集加载场景） #

若模块未加载托管程序集，可尝试导入指定版本、执行逻辑后卸载模块，但此方法无法解决已加载程序集的冲突问题，仅作补充：

#Requires -PSEdition Core
Install-Module -Name MyModule -RequiredVersion 2 -Scope CurrentUser -Force
Install-Module -Name MyModule -RequiredVersion 3 -Scope CurrentUser -Force

# 导入V2版本并执行脚本
Import-Module MyModule -RequiredVersion 2 -Force
& ~/UseV2.ps1
# 卸载模块（程序集仍保留在AppDomain中）
Remove-Module MyModule -Force

# 此步骤大概率仍会失败，因为V2的程序集未被卸载
Import-Module MyModule -RequiredVersion 3 -Force
& ~/UseV3.ps1

内容的提问来源于stack exchange，提问作者Daniel M.