Umbraco 8中无法遍历媒体文件夹问题求助

开发者阿泽

2026-5-13

解决Umbraco媒体文件夹遍历的NullReferenceException问题

嘿，这个空引用错误在Umbraco开发里挺常见的，咱们一步步来排查解决～

可能的触发原因

你遇到的System.NullReferenceException大概率是下面两种情况之一：

Model.Value<IEnumerable<IPublishedContent>>('mediaFolder')没有正确获取到目标媒体文件夹，直接返回了null，后续直接遍历空对象就触发了错误
媒体文件夹内的某个内容项本身是null（这种情况相对少见，但也得考虑到）

修复方案

方案1：添加Null检查+空集合兜底

先确保获取到的媒体集合不为空，再执行遍历操作，同时给单个媒体项也加个空判断，更稳妥：

@{
    // 若获取媒体文件夹失败返回null，则用空集合兜底，避免后续报错
    var media = Model.Value<IEnumerable<IPublishedContent>>("mediaFolder") ?? Enumerable.Empty<IPublishedContent>();
    
    foreach (var item in media)
    {
        // 额外检查当前媒体项是否为空
        if (item != null)
        {
            <img src="@item.Url" alt="@item.Name" />
        }
    }
}

方案2：针对旧版Umbraco的适配（Umbraco 7/8）

如果你使用的是Umbraco 7或8这类旧版本，可以用更贴合旧版API的TypedMediaList方法来获取媒体：

@{
    var media = Model.TypedMediaList("mediaFolder") ?? Enumerable.Empty<IPublishedContent>();
    
    foreach (var item in media)
    {
        if (item != null)
        {
            <img src="@item.Url" alt="@item.Name" />
        }
    }
}