如何解决Blazor Wasm发布构建时的AOT编译失败问题

问题根源 #

你遇到的是Blazor Wasm AOT编译器处理超大静态初始化代码块时的阈值限制：每个FooData有100个属性，1400个实例会生成极其庞大的IL代码，单个编译单元的代码量超出了当前.NET 6 AOT编译器的处理能力，导致预编译失败。

可行解决方案 #

1. 拆分初始化逻辑为多个小方法

将原本在单个方法中创建1400个实例的逻辑，拆分为多个批次创建的子方法，分散单个方法的IL代码量，避免触发编译器的单单元大小限制。

示例代码：

private void LoadFooData()
{
    var fooDataCollection = new List<FooData>();
    // 分批加载实例
    fooDataCollection.AddRange(CreateFooBatch1());
    fooDataCollection.AddRange(CreateFooBatch2());
    fooDataCollection.AddRange(CreateFooBatch3());
    fooDataCollection.AddRange(CreateFooBatch4());
    // 后续业务逻辑
}

// 每个批次创建350个实例（可根据实际情况调整批次大小）
private List<FooData> CreateFooBatch1()
{
    return new List<FooData>
    {
        new FooData { Prop1 = "Val1", Prop2 = "Val2", /* ... 其他98个属性 */ },
        new FooData { Prop1 = "Val3", Prop2 = "Val4", /* ... */ },
        // 共350个实例
    };
}

// 其他批次方法结构一致，分别创建剩余实例
private List<FooData> CreateFooBatch2() { /* ... */ }
private List<FooData> CreateFooBatch3() { /* ... */ }
private List<FooData> CreateFooBatch4() { /* ... */ }

2. 改用资源文件加载数据（最推荐）

彻底绕开硬编码实例带来的IL膨胀问题：将数据序列化为JSON/XML格式，嵌入为项目资源，运行时反序列化生成集合。

步骤：

• 创建foo-data.json文件，写入1400个FooData实例的JSON数据，将文件属性设置为嵌入的资源。
• 在LoadFooData中读取资源并反序列化：

using System.Text.Json;
using System.Reflection;

private void LoadFooData()
{
    var assembly = Assembly.GetExecutingAssembly();
    // 替换为你的项目命名空间+文件名
    using var stream = assembly.GetManifestResourceStream("YourAppNamespace.foo-data.json");
    using var reader = new StreamReader(stream);
    var jsonContent = reader.ReadToEnd();
    
    var fooDataList = JsonSerializer.Deserialize<List<FooData>>(jsonContent, new JsonSerializerOptions
    {
        PropertyNameCaseInsensitive = true
    });
    
    // 后续业务逻辑
}

3. 调整AOT编译参数（临时 workaround）

在项目文件中添加以下属性，提升AOT编译的内存限制或关闭部分优化，降低编译压力：

<PropertyGroup>
    <!-- 临时关闭Native优化，减少编译复杂度 -->
    <WasmNativeOptimizations>None</WasmNativeOptimizations>
    <!-- 增加AOT编译时的堆内存上限 -->
    <WasmMaxHeapSize>2048MB</WasmMaxHeapSize>
</PropertyGroup>

注意：关闭优化会导致最终Wasm文件的运行性能下降，仅作为临时解决方案。

4. 升级.NET 6 SDK到最新补丁版本

你当前使用的是.NET 6.0.16，微软在后续的.NET 6补丁版本（如6.0.25）中修复了多个AOT编译的稳定性问题，升级后可能自动解决该阈值触发的编译失败。

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