MudBlazor DataGrid本地Blazor Server环境下无法渲染项求助

云上老周

2026-7-26

MudBlazor DataGrid在Blazor Server本地环境不渲染项的排查方向

你提供的代码在在线环境中正常运行，但本地Blazor Server环境下无法渲染数据项，可从以下几个方向排查：

你的代码示例

<p>Before</p>

<MudDataGrid Items="@Elements">
    <Columns>
        <PropertyColumn Property="x => x.Name"/>
    </Columns>
</MudDataGrid>

<p>After</p>

@code {
    private IEnumerable<Element> Elements = new List<Element>();
    
    protected override void OnInitialized()
    {
        Elements = new List<Element>
        {
            new Element { Name = "Test 1" },
            new Element { Name = "Test 2" },
            new Element { Name = "Test 3" }
        };
    }

    public class Element
    {
        public string Name { get; set; }
    }
}

可能的原因及解决方法

MudBlazor版本不匹配：在线环境默认使用最新稳定版，本地项目若版本过低，可能存在API兼容性问题（比如PropertyColumn的用法在旧版本中不支持）。检查本地NuGet包，将MudBlazor版本更新至与在线环境一致。
Blazor Server项目未完成MudBlazor初始化配置：
- 确认Program.cs中已注册MudBlazor服务：
```
builder.Services.AddMudServices();
```
- 确认_Imports.razor中已导入MudBlazor命名空间：
```
@using MudBlazor
```
静态资源未正确引入：Blazor Server项目需要在_Layout.cshtml中引入MudBlazor的CSS和JS资源，否则组件样式和功能会异常：
```
<link href="_content/MudBlazor/MudBlazor.min.css" rel="stylesheet" />
<script src="_content/MudBlazor/MudBlazor.min.js"></script>
```
组件更新未触发：虽然代码中直接替换了Elements集合，但极端情况下可尝试手动触发组件更新，在OnInitialized末尾添加StateHasChanged();（一般无需此操作，但可用于排查）。
浏览器控制台存在报错：打开浏览器开发者工具，查看控制台是否有JS错误或.NET异常，比如资源加载失败、组件初始化异常等，这些都会导致DataGrid无法正常渲染。