ASP.NET Core MVC：分部视图模型属性在Razor中变为null无法渲染

这种情况确实挺让人头疼的——明明调试时BatteryLevelTooltip属性有预期值，结果到视图渲染环节就变成null，偏偏其他同方式传递的数据又正常。我来分享几个实战中排查这类问题的思路，你可以逐一验证：

1. 确认分部视图的模型声明是否正确 #

• 首先检查分部视图顶部的@model指令，确保它引用的是你实际传递的ViewModel类型，有没有不小心写成父视图的模型，或者其他无关的类？比如如果父视图模型是DeviceDashboardVM，而你传递的是它的子模型BatteryStatusVM，那分部视图必须写@model YourApp.Models.BatteryStatusVM，类型不匹配会导致属性绑定失效，悄悄返回null。
• 另外，排查分部视图内部有没有重复定义同名变量，比如在视图里写了@{ var BatteryLevelTooltip = null; }，这会直接覆盖模型属性的值。

2. 检查模型传递的环节 #

• 如果是通过@Html.Partial("BatteryPartial", Model.BatteryStatus)传递子模型，确认父视图中在渲染分部视图之后，有没有代码无意中修改了Model.BatteryStatus.BatteryLevelTooltip？比如后续的异步操作、事件处理逻辑，会不会把这个属性重置为null？
• 如果用了ViewData/ViewBag传递（比如ViewData["BatteryTooltip"] = Model.BatteryLevelTooltip），要检查键名是否拼写一致，以及有没有其他代码在后面覆盖了这个键的值——比如某段代码误写了ViewData["BatteryTooltip"] = ""或者null。

3. 排查视图渲染的时机与缓存 #

• 有没有可能分部视图是在数据加载完成前渲染的？比如你用了异步方法获取电池数据，但分部视图在await操作完成前就被渲染了？不过你说调试时属性有值，这个可能性较低，但可以确认分部视图的渲染位置是否在数据初始化之后。
• 检查分部视图或父视图是否启用了输出缓存，比如有没有加[OutputCache(Duration = 3600)]特性，或者页面级的缓存设置？如果缓存了旧的null值，新数据就不会被渲染出来。

4. 检查ViewModel属性的实现逻辑 #

• 看看BatteryLevelTooltip属性有没有自定义的getter/setter逻辑？比如下面这种情况：

  private string _batteryLevelTooltip;
  public string BatteryLevelTooltip 
  { 
      get 
      {
          // 某些条件下返回null
          return _batteryLevelTooltip ?? GetDefaultTooltip(); 
      }
      set { _batteryLevelTooltip = value; }
  }
  

  调试时你可能直接访问了_batteryLevelTooltip字段看到有值，但后续通过属性getter访问时，因为某些条件变化（比如_batteryLevelTooltip被意外清空），导致返回null。

5. 直接在分部视图中输出调试信息 #

• 在分部视图的最开头加一行代码，直接输出模型属性或整个模型的序列化内容：

  <!-- 输出单个属性 -->
  @Model.BatteryLevelTooltip
  <!-- 输出整个模型的JSON，方便查看完整状态 -->
  @Html.Raw(Newtonsoft.Json.JsonConvert.SerializeObject(Model))
  

  这样能看到视图渲染时模型的真实状态，有时候调试器显示的是某个时刻的值，但渲染时模型已经被修改了，直接输出能帮你定位差异。

如果以上思路都没解决问题，你可以把分部视图的模型声明代码、传递模型的代码，以及ViewModel中BatteryLevelTooltip属性的定义贴出来，这样更容易精准定位问题。

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