ASP.NET MVC视图模型类型不匹配：传递List<Movie>却提示需RandomMovieViewModel

错误现象 #

展示ASP.NET MVC项目的Index.cshtml视图时，出现错误：

传递给字典的模型项类型为'System.Collections.Generic.List`1[Web_Course.Models.Movie]'，但该字典需要类型为'Web_Course.ViewModels.RandomMovieViewModel'的模型项。

已确认控制器传递IEnumerable<Movie>，视图声明@model IEnumerable<Web_Course.Models.Movie>，但错误关联到RandomMovieViewModel，以下是排查方向：

可能原因及排查步骤 #

1. 视图文件路径不匹配 #

控制器默认查找~/Views/{控制器名}/{Action名}.cshtml，但以下情况会导致加载错误视图：

• ~/Views/Shared/Index.cshtml存在且声明了RandomMovieViewModel模型
• 视图文件路径拼写错误（比如Movie文件夹名称有误）
• 项目包含区域(Area)，当前访问的是区域内的MovieController而非根目录控制器

排查操作：

• 确认访问URL对应根目录的Movie/Index
• 打开~/Views/Movie/Index.cshtml，再次核对顶部的@model声明

2. 视图缓存未更新 #

ASP.NET MVC会缓存编译后的视图，即使修改了视图文件，缓存未刷新时仍会加载旧版本（旧视图可能声明了RandomMovieViewModel）。

排查操作：

• 重启Visual Studio和项目
• 删除项目目录下的bin和obj文件夹，重新编译项目

3. 布局页或部分视图依赖错误模型 #

如果_Layout.cshtml或视图引用的部分视图声明了RandomMovieViewModel模型，会导致整体模型类型冲突。

排查操作：

• 打开~/Views/Shared/_Layout.cshtml，检查是否有@model声明，或是否调用@Html.Partial等方法传递了错误模型
• 检查Index视图中是否引用了需要RandomMovieViewModel的部分视图

4. 控制器Action存在重载或返回错误视图 #

需确认：

• 没有其他重载的Index Action返回RandomMovieViewModel
• return View(movies)未指定错误的视图名称（比如return View("RandomMovie", movies)）

排查操作：

• 检查MovieController中所有Index相关的Action方法
• 确认return View(movies)未指定错误视图名

相关代码参考 #

Index视图代码 #

@model IEnumerable<Web_Course.Models.Movie>
@{
    ViewBag.Title = "Index";
    Layout = "~/Views/Shared/_Layout.cshtml";
}

<h2>Movies</h2>

<table class="table table-bordered table-hover">
    <thead>
    <tr>
        <th>Movie</th>
    </tr>
    </thead>
    <tbody>
    @foreach (var movie in Model)
    {
        <tr>
            <td>@movie.Name</td>
        </tr>
    }
    </tbody>
</table>

Movie控制器代码 #

public class MovieController : Controller
{
    // GET: Movie
    public ActionResult Index()
    {
        var movies = GetMovies();
        return View(movies);
    }

    private IEnumerable<Movie> GetMovies()
    {
        return new List<Movie>
        {
            new Movie { Id = 1, Name = "John Wick" },
            new Movie { Id = 2, Name = "Oppenheimer" }
        };
    }
}

Movie模型代码 #

namespace Web_Course.Models
{
    public class Movie
    {
        public int Id { get; set; }
        public string Name { get; set; }
    }
}

RandomMovieViewModel代码 #

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using Web_Course.Models;

namespace Web_Course.ViewModels
{
    public class RandomMovieViewModel
    {
        public Movie Movie { get; set; }
        public List<Customer> Customers { get; set; }
    }
}

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