ASP.NET Core 5 Web API用EF脚手架搭建控制器包还原失败如何解决

该报错是脚手架工具执行时触发了不符合预期的NuGet包还原流程，还原失败后触发的回滚操作，结合你已有2个控制器生成成功的前提，常见触发原因如下：

• SpecialAbilities模型未符合EF Core主键约定：脚手架默认会寻找名为Id或类名+Id的字段作为主键，你当前的主键为PlayerId，未显式声明的情况下脚手架识别异常，触发错误的依赖修复逻辑
• EF Core相关NuGet包版本不统一：项目内已安装的Microsoft.EntityFrameworkCore系列包版本不一致，或与脚手架默认拉取的版本冲突
• 项目DbContext未添加SpecialAbilities对应的DbSet配置，脚手架检测到实体未注册，触发异常流程
• 本地NuGet源缓存异常，导致包拉取失败

按顺序执行以下操作即可解决：

1. 修正模型的主键声明 #

给PlayerId字段添加主键特性，需先引入对应命名空间：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations; // 新增引用

#nullable disable

namespace CyberpunkAPI.Models
{
    public partial class SpecialAbilities
    {
        [Key] // 新增主键特性
        public int PlayerId { get; set; }
        public int? Authority { get; set; }
        public int? CharismaticLeadership { get; set; }
        public int? CombatSense { get; set; }
        public int? Credibility { get; set; }
        public int? Family { get; set; }
        public int? Interface { get; set; }
        public int? JuryRig { get; set; }
        public int? MedicalTech { get; set; }
        public int? Resources { get; set; }
        public int? Streedeal { get; set; }

        // 后续需要使用导航属性时取消注释即可，需确保Player实体已存在且DbContext已注册
        //public virtual Player Player { get; set; }
    }
}

如果你使用Fluent API配置实体关系，也可以直接在DbContext的OnModelCreating方法中指定SpecialAbilities的主键为PlayerId，效果一致。

2. 确认DbContext已注册实体 #

在你的项目DbContext类中，添加SpecialAbilities对应的DbSet：

public DbSet<SpecialAbilities> SpecialAbilities { get; set; }

3. 统一EF Core包版本 #

右键项目 -> 选择「管理NuGet程序包」-> 切换到「已安装」标签，确认所有Microsoft.EntityFrameworkCore开头的包版本统一为5.x版本，和你的项目框架版本匹配，禁止出现跨大版本的包混用。

4. 清理缓存重试 #

• 右键项目点击「清理」
• 删除项目根目录下的bin、obj文件夹
• 右键解决方案点击「还原NuGet包」，确认还原无报错
• 重启Visual Studio后重新执行脚手架生成操作即可

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