Blazor WASM运行时加载RCL模块的Rider调试方案问询

问题背景 #

正在构建模块化Blazor WebAssembly应用，将独立的Razor Class Library（RCL）作为插件在运行时加载，主Shell项目不引用这些模块以实现开发分离。

当前实现方式 #

• 模块独立编译（目前在同一解决方案内）
• 模块的DLL和PDB文件通过API提供给Shell
• Shell应用使用AssemblyLoadContext.Default.LoadFromStream(dllStream, pdbStream)动态加载模块

目标 #

在Docker中运行的Blazor WebAssembly（Shell）进程附加调试器时，启用动态加载模块的调试功能：模块开发者可独立构建并提供DLL/PDB文件后，通过附加到运行中的Shell调试代码。

环境 #

• .NET 9
• Blazor WebAssembly
• Rider（Visual Studio调试正常）

当前问题 #

调试未正常工作。在Rider中为模块代码设置断点时，IDE提示以下信息之一：

"/path/to/module/file.cs is not found among the loaded symbol documents"
"Didn't find associated module for /path/to/module/file.cs"

调试模块列表中仅显示Shell（Shell调试正常），模块未被列出。

示例代码 #

// AssemblyLoader.cs 
public async Task<List<Assembly>> LoadAdditionalAssemblies() 
{ 
    var dll = await _httpClient.GetAsync("Modules/ModuleExample/ModuleExample.dll");
    var pdb = await _httpClient.GetAsync("Modules/ModuleExample/ModuleExample.pdb");
    await using var dllStream = await dll.Content.ReadAsStreamAsync();
    await using var pdbStream = await pdb.Content.ReadAsStreamAsync();
    
    var assembly = AssemblyLoadContext.Default.LoadFromStream(dllStream, pdbStream);

    return [assembly];
}

可行性与解决方案 #

该需求完全可行，针对Rider的调试问题，需从符号匹配、加载上下文、调试配置三方面调整：

1. 确保DLL与PDB版本完全匹配 #

模块编译时必须保证DLL和PDB是同一编译产物，禁止混用不同构建版本的文件。建议模块构建后将DLL和PDB打包发布，避免手动拆分导致版本不匹配。

2. 使用自定义AssemblyLoadContext加载模块 #

避免直接使用AssemblyLoadContext.Default，改为创建自定义加载上下文，便于Rider识别独立模块：

public class ModuleLoadContext : AssemblyLoadContext
{
    public ModuleLoadContext() : base(isCollectible: false) { }

    protected override Assembly? Load(AssemblyName assemblyName)
    {
        // 优先复用Shell已加载的依赖，避免重复加载
        return null;
    }
}

// 修改加载逻辑
var loadContext = new ModuleLoadContext();
var assembly = loadContext.LoadFromStream(dllStream, pdbStream);

3. 配置Rider的符号与源码映射 #

• 打开Run > Edit Configurations，选择Blazor WASM调试项
• 切换到Debugger标签页，在Symbol paths中添加模块PDB的本地/网络共享路径
• 在Source paths中添加模块项目的源码根目录，确保Rider能将PDB中的文件路径映射到本地源码

4. Docker环境调试适配 #

• 确保Docker容器的Shell端口（默认5000/5001）已映射到主机，Rider可通过远程调试连接容器内进程
• 若模块PDB通过API提供，需在Rider中配置Settings > Build, Execution, Deployment > Debugger > Path Mappings，将PDB中的文件路径映射到本地源码路径

5. 验证符号加载状态 #

模块加载完成后，可通过以下代码验证符号是否正确加载（仅用于调试）：

foreach (var document in assembly.GetSymbolDocumentNames())
{
    Console.WriteLine($"Loaded symbol document: {document}");
}

若输出包含模块的.cs文件路径，说明符号加载成功，Rider应能识别断点。

内容的提问来源于stack exchange，提问作者Filip Martiník