简介面向.NET开发者和毕业设计学生的ASP.NET Core 3.1学生信息管理系统源码包基于VS2019与SQL Server 2014环境采用C#、ASP.NET Core MVC后端集成EF Core与yrjw.ORM.Chimp覆盖基础信息管理、部门列表、学生信息列表等典型功能适合课程设计、毕业设计或初学Core分层架构的读者对照实践。压缩包内共1291个文件整体约50.06MB以dll、cs、cshtml、json、js、css等为主既有可直接编译的源码也包含运行文档、数据库备份与调试所需文件还原数据库后即可运行验证减少从零配置成本。目录按功能模块划分便于定位业务逻辑和二次开发同时保留调试符号与项目缓存信息对梳理请求处理链路、观察EF Core查询执行过程有一定帮助。随包附带的数据库备份文件还能快速还原学生与部门数据便于做增删改查等扩展练习。已有139人学习/下载适合需要快速搭建学生信息管理模块或学习ASP.NET Core 3.1实际项目结构的人群。1. MF00503-Core 3.1 学生信息源码这个压缩包里装的是什么MF00503-Core 3.1 学生信息源码.zip这种命名多半是课程设计作业、毕业设计存档也可能是同事从项目库里导出来的一份交付备份。文件名本身已经交代了全部线索MF00503是课题编号Core 3.1是目标框架学生信息是业务域zip是传输介质。目前在高校和中小型外包团队里这类项目还在大量流通很多刚入行的人拿到手第一个动作是双击解压然后对着解决方案里十几个项目发呆。这类系统的本质就是一个标准的三层增删改查学生表的新增、编辑、删除、列表和搜索。真正花时间的不是业务功能而是把它跑通的过程。 Core 3.1已经过了官方支持期但运行环境和依赖项的坑比新框架更多。这篇文章就顺着拿到这个zip之后的完整路径来讲怎么拆包、怎么还原依赖、怎么把数据库建起来、怎么改动实体和页面、最后怎么发布到服务器上。适合正在做课程设计的学生、接手这类旧系统的开发以及准备把项目改造落地的外包工程师。2. Core 3.1 学生信息系统的分层Controller、Service、Repository 怎么分工拿到zip并解压后第一件事不是双击sln文件而是先看项目结构。一个标准的ASP.NET Core 3.1学生信息系统解决方案里至少会有这样几个目录。2.1 从 MF00503 项目结构看 Core 3.1 的标准骨架MF00503/ ├── Controllers/ │ ├── StudentsController.cs │ └── AccountController.cs ├── Views/ │ ├── Students/ │ │ ├── Index.cshtml │ │ ├── Create.cshtml │ │ ├── Edit.cshtml │ │ └── Delete.cshtml │ └── Shared/ ├── Models/ │ ├── Student.cs │ ├── StudentViewModel.cs │ └── ErrorViewModel.cs ├── Data/ │ └── ApplicationDbContext.cs ├── Repositories/ │ └── StudentRepository.cs ├── Services/ │ └── StudentService.cs ├── Migrations/ ├── appsettings.json └── Startup.csControllers 是HTTP请求的入口负责接收参数、调用业务层、返回视图或JSON。Models 里放的是实体类和视图模型ViewModel实体类对应数据库表结构视图模型对应页面提交的表单结构。Data 目录放EF Core的DbContextRepositories 封装具体的数据访问逻辑Services 写业务规则——比如学号不能重复、删除前要检查是否有选课记录这类判断。为什么一个学生增删改查要拆成这么多层我一般给出的解释是如果所有逻辑都写在Controller里刚开始跑得很快但一旦要加专业、班级、选课、成绩单这些关联模块Controllers 会迅速膨胀成上千行的上帝类。分层的目的不是让代码变多而是让每个类的职责边界清晰测试的时候可以单独 mock Repository替换数据库时也不用动Controller。2.2 Startup.cs 里决定了这个系统的依赖注入与请求管道2.2.1 ConfigureServices 与三个核心注册Startup.cs 是 Core 3.1 系统启动时的装配中心。以典型的学生信息项目为例ConfigureServices 里通常长这样public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(); services.AddDbContextApplicationDbContext(options options.UseSqlServer( Configuration.GetConnectionString(DefaultConnection))); services.AddScopedIStudentRepository, StudentRepository(); services.AddScopedIStudentService, StudentService(); }AddDbContext 注册的是EF Core的数据库上下文它默认的生命周期是 Scoped——也就是每个HTTP请求创建一个实例请求结束后释放。AddScoped 同理Controller 和 Repository 在同一个请求里拿到的是同一个实例内存里的变更可以共享。与之相对AddSingleton 全进程只有一个实例适合放配置读取器AddTransient 每次获取都新建适合无状态工具类。拿到源码后要确认三件事这几个依赖是否都注册了、数据库连接字符串是否指向有效实例、以及用的EF Core版本是3.1还是5.0。版本不匹配时即使编译通过运行时也会抛 InvalidOperationException。2.2.2 Configure 方法里的管道顺序Configure 方法中UseStaticFiles 和 UseRouting 的顺序非常敏感。Core 3.1 的起点是 UseStaticFiles它让 wwwroot 下的 css、js、图片能被直接访问接着是 UseRouting 和 UseEndpoints它们负责把 URL 分发给对应的 Controller Action。学生信息项目经常出现页面样式丢光的现象多数是漏了 app.UseStaticFiles()或者把它写到了 UseRouting 之后。public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler(/Home/Error); } app.UseStaticFiles(); app.UseRouting(); app.UseEndpoints(endpoints { endpoints.MapControllerRoute( name: default, pattern: {controllerStudents}/{actionIndex}/{id?}); }); }MapControllerRoute 里 pattern 的含义是第一个路径段是控制器名去掉Controller后缀第二个段是Action名第三个是可选id参数。默认路由指向 StudentsController 的 Index 方法这样用户访问根地址时直接进入学生列表。2.3 MVC 请求在 Core 3.1 里怎么流转一个典型的请求流转过程是这样的浏览器访问 /Students/Index路由解析出 controllerStudents、actionIndexMVC 中间件通过依赖注入容器创建 StudentsController 实例构造器里注入的 IStudentService 再由容器创建并注入Action 方法调用 service.GetAll()service 调用 repository.GetAll()repository 使用 ApplicationDbContext 向SQL Server发查询数据返回后组装成 StudentViewModel 列表交给 Index.cshtml 渲染成HTML。关键在于理解异步Action 方法几乎都声明为async TaskIActionResult内部用到await _context.Students.ToListAsync()。EF Core 的异步方法不会阻塞线程池线程这是高并发下保持吞吐量的核心。如果在源码里看到同步写法 .ToList() 而不是 .ToListAsync()建议顺手改掉。这一层的判断标准很简单Controller 里不该出现 new DbContext()Repository 里不该写业务判断。看到这些就说明原代码的封装已经走样了。3. 把 zip 里的 Core 3.1 学生信息源码跑起来解压到端口的五个步骤理论看完了现在进入实际落地环节。目标是在一台干净的 Windows 或 Linux 开发机上把源码跑成一个能访问的网站。3.1 解压并核对运行时版本先解压注意文件名里有空格用引号包裹unzip MF00503-Core 3.1 学生信息源码.zip -d MF00503 cd MF00503 dotnet --list-sdksunzip的 -d 参数指定解压目标目录避免文件散落一地。dotnet --list-sdks输出当前机器上安装的所有 .NET SDK 版本。Core 3.1 项目的目标框架是 netcoreapp3.1需要本机装有 3.1.100 到 3.1.426 之间的 SDK。如果机器上只有 .NET 6 或 .NET 8直接 restore 会报错“目标框架 netcoreapp3.1 不可用”就算手动编辑 csproj 改成 net6.0也未必兼容因为依赖包可能引用了已过时的 API。查看项目文件确认目标框架head -5 MF00503.csprojcsproj 里TargetFrameworknetcoreapp3.1/TargetFramework与 SDK 版本必须对应。建议直接安装 3.1.426 版本这是 Core 3.1 的最终SDK版本之后不会再有小版本更新。装完再执行 dotnet --list-sdks确认出现对应版本号。3.2 配置数据库连接字符串与迁移策略3.2.1 修改 appsettings.json 中的连接字符串{ ConnectionStrings: { DefaultConnection: Server(localdb)\\mssqllocaldb;DatabaseStudentDb;Trusted_ConnectionTrue;MultipleActiveResultSetstrue }, Logging: { LogLevel: { Default: Information, Microsoft: Warning, Microsoft.Hosting.Lifetime: Information } }, AllowedHosts: * }Server(localdb)\\mssqllocaldb是SQL Server Express LocalDB的默认实例名适合开发环境不需要额外安装服务。Trusted_ConnectionTrue表示用Windows身份验证登录。MultipleActiveResultSetstrue允许在同一连接上并行执行多个查询学生列表和详情页经常同时用到多个DbContext查询这个参数建议保留。Production环境里这段配置会被 appsettings.Production.json 覆盖后面第5章会讲。3.2.2 还原依赖并更新数据库dotnet restore dotnet ef database update dotnet rundotnet restore根据 csproj 里的 PackageReference 从 NuGet 下载依赖。dotnet ef database update会把 Migrations 目录下的所有迁移应用到数据库建出学生表、班级表等实体对应的数据表。执行前要确认当前目录下有 Migrations 文件夹并且这个项目引用了Microsoft.EntityFrameworkCore.Design包——否则会报“无法执行此操作因为没有数据库提供程序”这类错误需要手动添加包。3.3 启动后验证网站与数据库运行dotnet run后命令行会输出监听的地址默认是 http://localhost:5000。浏览器访问 /Students/Index正常会出现学生列表页。如果页面报数据库不存在回到命令行执行dotnet ef database update创建库如果报表不存在说明迁移没有包含当前实体结构需要重新生成迁移。3.3.1 常见启动失败的速查表现象原因处理方式HTTP 500 且日志里有“数据库不存在”连接字符串指向了不存在的库实例先启动SQL Server服务或改连接字符串指向已有实例页面样式和图片全部丢失缺少 UseStaticFiles在 Startup.cs 的 UseRouting 前补上app.UseStaticFiles()端口 5000 被占用另一进程正在监听该端口dotnet run --urls http://localhost:8080dotnet ef 命令不存在未安装 EF 工具或未安装 Design 包dotnet tool install --global dotnet-efdotnet run --urls可以临时指定监听端口开发调试时很常用不用改启动配置就能换端口。线上部署通常用 Environment 变量 ASPNETCORE_URLS 来指定监听地址两者的优先级以环境变量为先。端口跑通的标志是能看到 StudentsController 的 Index 页面这证明路由分发正常、依赖注入容器已成功构建、EF Core 能查出数据并完成模型绑定。4. 给 Core 3.1 学生信息源码加一个“籍贯”字段Code First 改动的完整过程跑通之后接得最多的需求是改字段。比如学生表要加“籍贯 NativePlace”下面按 EF Core Code First 的流程走一遍完整改动。如果原项目用的是 DB First从数据库生成模型这段流程要先改成手动改数据库和实体再重新生成模型。4.1 修改实体类与视图模型在 Models/Student.cs 中添加字段using System.ComponentModel.DataAnnotations; namespace MF00503.Models { public class Student { public int Id { get; set; } [Required] [StringLength(50)] public string Name { get; set; } [Required] [StringLength(20)] public string StudentNo { get; set; } // 新增字段 [StringLength(100)] public string NativePlace { get; set; } } }[StringLength(100)]和[Required]都是 System.ComponentModel.DataAnnotations 里自带的数据注解EF Core 会把这些特性映射成数据库列的 NVARCHAR(100) 和 NOT NULL。只给实体加字段但不加注解字段会生成可空列表单验证也不会拦截空值。如果项目里 Controller 直接绑定的是 Student 实体那么表单提交时会自动把同名属性绑定到 NativePlace如果用的是 StudentViewModel需要同步在 ViewModel 里加上这个属性。4.2 生成并执行迁移在项目目录下执行dotnet ef migrations add AddNativePlaceToStudent dotnet ef database updatemigrations add会读取当前实体的状态与上次迁移记录的差异生成一个带有时间戳的迁移类。类里有 Up 和 Down 两个方法Up 是应用本次变更的代码Down 是回滚操作。database update则把所有未应用的迁移按顺序执行到目标数据库。生成的迁移代码大致是这样protected override void Up(MigrationBuilder migrationBuilder) { migrationBuilder.AddColumnstring( name: NativePlace, table: Students, type: nvarchar(100), nullable: true); } protected override void Down(MigrationBuilder migrationBuilder) { migrationBuilder.DropColumn( name: NativePlace, table: Students); }如果项目里没有 Migrations 目录说明原开发者可能用的是 CreateDatabase 的方式建库这时不能直接执行 migrations add。兜底方案是先手动建库再执行下面这条 SQL 把字段加进去ALTER TABLE Students ADD NativePlace NVARCHAR(100) NULL;要查看数据库是否真的更新成功可以用 SQL Server Management Studio 连接连接字符串指定的实例展开表结构确认 NativePlace 列存在。4.3 修改 Razor 视图加入表单控件4.3.1 Create.cshtml 与 Edit.cshtml 中的表单div classform-group label asp-forNativePlace classcontrol-label/label input asp-forNativePlace classform-control / span asp-validation-forNativePlace classtext-danger/span /divasp-for是 Razor 的 Tag Helper 语法它会把生成的 label 的 for 属性、input 的 name 属性和 id 属性都绑定到 Student.NativePlace 上。表单提交时模型绑定器根据 name 属性找到对应的值填充到 Student 实体的 NativePlace 属性里。asp-validation-for生成客户端验证的占位符对应实体上的 [StringLength(100)] 特性会被编译成>th籍贯/th ... tditem.NativePlace/td列表页不加这行不影响功能但用户看不到新录入的数据会以为是代码没生效。4.4 常见的误用只改实体不跑迁移只改 Student.cs不执行 migrations add运行后访问列表页不会报错因为页面查询的是 Select 列表里没有的列。但一旦进入 Create 页面提交新学生EF Core 生成的 INSERT 语句里会包含 NativePlace 列SQL Server 直接抛Invalid column name NativePlace。遇到这个错误时记住实体是代码层的映射数据库列是另一回事两者必须同步。同理手动执行 ALTER TABLE 后没有同步实体EF Core 查询时会忽略新增列不会报错但实体上依然读不到这个字段。这是 DB First 项目最容易踩的坑改完数据库还要回代码里补属性并重新生成模型。整个流程走完后需要再跑一遍添加工、编辑、删除、搜索学生。其中删除页如果调用了FindAsync因为加了字段不影响主键查找但如果列表有搜索框且搜索条件含多个列要检查 Search 方法里的表达式是否包含了字符串拼错的字段名。5. 发布与验收Core 3.1 学生信息系统的上线前检查清单最后一步是发布部署。很多学生项目交付时只给源码和运行说明但实际接手的人需要在服务器上把它变成可执行的网站。5.1 用 publish 输出自包含的部署目录dotnet publish -c Release -o ./publish-c Release是发布配置对应 csproj 里的 Release 条件编译符号-o ./publish指定输出目录。发布完成后publish 文件夹里有 MF00503.dll、MF00503.exeWindows、Views 和 wwwroot。服务器上只需要安装 ASP.NET Core 3.1 Runtime 就能运行不需要 SDK。启动方式在 publish 目录下执行dotnet MF00503.dll默认监听 5000 端口。5.2 用环境配置覆盖连接字符串服务器上的数据库连接不能写在 appsettings.json 里因为在仓库里的文件很容易被多人看到。常见做法是把生产环境配置放进 appsettings.Production.json或用环境变量覆盖。最简单的方案是设置系统环境变量export ConnectionStrings__DefaultConnectionServerprod-db;DatabaseStudentDb;User Idsa;Passwordxxx这个双下划线语法是 Core 3.1 配置体系的标准约定环境变量名ConnectionStrings__DefaultConnection会映射到配置节点 ConnectionStrings:DefaultConnection。该配置优先级高于 appsettings.json所以不用改文件就能切换数据库。5.3 三个核心流程的验证顺序上线前逐项验证先访问学生列表页确认页面正常渲染再新增一条带籍贯字段的记录刷新列表确认显示然后编辑这条记录改掉姓名和学号确认更新成功最后删除它确认没有外键约束卡住。数据库有外键关联选课表时删除会把整条事务失败这时要检查业务规则是提示错误还是级联删除。收尾的一个技巧使用 dotnet ef migrations script 把全部迁移生成一份独立 SQL 文件dotnet ef migrations script -o deploy.sql把 deploy.sql 和 publish 目录一起交给运维或评审老师对方不需要安装 dotnet-ef 工具用 SSMS 执行一次脚本就能把生产库结构准备好。对于 Core 3.1 这种已经停止支持的框架保留一份可执行的 SQL 脚本比依赖 Migration 运行时更新更稳妥因为生产环境装 SDK 的意愿通常很低。发布目录里留一份 deploy.sql后续排查表结构差异时也有据可查。本文还有配套的精品资源点击获取
ASP.NET Core 3.1学生信息系统源码解析：从分层架构到发布部署全流程
简介面向.NET开发者和毕业设计学生的ASP.NET Core 3.1学生信息管理系统源码包基于VS2019与SQL Server 2014环境采用C#、ASP.NET Core MVC后端集成EF Core与yrjw.ORM.Chimp覆盖基础信息管理、部门列表、学生信息列表等典型功能适合课程设计、毕业设计或初学Core分层架构的读者对照实践。压缩包内共1291个文件整体约50.06MB以dll、cs、cshtml、json、js、css等为主既有可直接编译的源码也包含运行文档、数据库备份与调试所需文件还原数据库后即可运行验证减少从零配置成本。目录按功能模块划分便于定位业务逻辑和二次开发同时保留调试符号与项目缓存信息对梳理请求处理链路、观察EF Core查询执行过程有一定帮助。随包附带的数据库备份文件还能快速还原学生与部门数据便于做增删改查等扩展练习。已有139人学习/下载适合需要快速搭建学生信息管理模块或学习ASP.NET Core 3.1实际项目结构的人群。1. MF00503-Core 3.1 学生信息源码这个压缩包里装的是什么MF00503-Core 3.1 学生信息源码.zip这种命名多半是课程设计作业、毕业设计存档也可能是同事从项目库里导出来的一份交付备份。文件名本身已经交代了全部线索MF00503是课题编号Core 3.1是目标框架学生信息是业务域zip是传输介质。目前在高校和中小型外包团队里这类项目还在大量流通很多刚入行的人拿到手第一个动作是双击解压然后对着解决方案里十几个项目发呆。这类系统的本质就是一个标准的三层增删改查学生表的新增、编辑、删除、列表和搜索。真正花时间的不是业务功能而是把它跑通的过程。 Core 3.1已经过了官方支持期但运行环境和依赖项的坑比新框架更多。这篇文章就顺着拿到这个zip之后的完整路径来讲怎么拆包、怎么还原依赖、怎么把数据库建起来、怎么改动实体和页面、最后怎么发布到服务器上。适合正在做课程设计的学生、接手这类旧系统的开发以及准备把项目改造落地的外包工程师。2. Core 3.1 学生信息系统的分层Controller、Service、Repository 怎么分工拿到zip并解压后第一件事不是双击sln文件而是先看项目结构。一个标准的ASP.NET Core 3.1学生信息系统解决方案里至少会有这样几个目录。2.1 从 MF00503 项目结构看 Core 3.1 的标准骨架MF00503/ ├── Controllers/ │ ├── StudentsController.cs │ └── AccountController.cs ├── Views/ │ ├── Students/ │ │ ├── Index.cshtml │ │ ├── Create.cshtml │ │ ├── Edit.cshtml │ │ └── Delete.cshtml │ └── Shared/ ├── Models/ │ ├── Student.cs │ ├── StudentViewModel.cs │ └── ErrorViewModel.cs ├── Data/ │ └── ApplicationDbContext.cs ├── Repositories/ │ └── StudentRepository.cs ├── Services/ │ └── StudentService.cs ├── Migrations/ ├── appsettings.json └── Startup.csControllers 是HTTP请求的入口负责接收参数、调用业务层、返回视图或JSON。Models 里放的是实体类和视图模型ViewModel实体类对应数据库表结构视图模型对应页面提交的表单结构。Data 目录放EF Core的DbContextRepositories 封装具体的数据访问逻辑Services 写业务规则——比如学号不能重复、删除前要检查是否有选课记录这类判断。为什么一个学生增删改查要拆成这么多层我一般给出的解释是如果所有逻辑都写在Controller里刚开始跑得很快但一旦要加专业、班级、选课、成绩单这些关联模块Controllers 会迅速膨胀成上千行的上帝类。分层的目的不是让代码变多而是让每个类的职责边界清晰测试的时候可以单独 mock Repository替换数据库时也不用动Controller。2.2 Startup.cs 里决定了这个系统的依赖注入与请求管道2.2.1 ConfigureServices 与三个核心注册Startup.cs 是 Core 3.1 系统启动时的装配中心。以典型的学生信息项目为例ConfigureServices 里通常长这样public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(); services.AddDbContextApplicationDbContext(options options.UseSqlServer( Configuration.GetConnectionString(DefaultConnection))); services.AddScopedIStudentRepository, StudentRepository(); services.AddScopedIStudentService, StudentService(); }AddDbContext 注册的是EF Core的数据库上下文它默认的生命周期是 Scoped——也就是每个HTTP请求创建一个实例请求结束后释放。AddScoped 同理Controller 和 Repository 在同一个请求里拿到的是同一个实例内存里的变更可以共享。与之相对AddSingleton 全进程只有一个实例适合放配置读取器AddTransient 每次获取都新建适合无状态工具类。拿到源码后要确认三件事这几个依赖是否都注册了、数据库连接字符串是否指向有效实例、以及用的EF Core版本是3.1还是5.0。版本不匹配时即使编译通过运行时也会抛 InvalidOperationException。2.2.2 Configure 方法里的管道顺序Configure 方法中UseStaticFiles 和 UseRouting 的顺序非常敏感。Core 3.1 的起点是 UseStaticFiles它让 wwwroot 下的 css、js、图片能被直接访问接着是 UseRouting 和 UseEndpoints它们负责把 URL 分发给对应的 Controller Action。学生信息项目经常出现页面样式丢光的现象多数是漏了 app.UseStaticFiles()或者把它写到了 UseRouting 之后。public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler(/Home/Error); } app.UseStaticFiles(); app.UseRouting(); app.UseEndpoints(endpoints { endpoints.MapControllerRoute( name: default, pattern: {controllerStudents}/{actionIndex}/{id?}); }); }MapControllerRoute 里 pattern 的含义是第一个路径段是控制器名去掉Controller后缀第二个段是Action名第三个是可选id参数。默认路由指向 StudentsController 的 Index 方法这样用户访问根地址时直接进入学生列表。2.3 MVC 请求在 Core 3.1 里怎么流转一个典型的请求流转过程是这样的浏览器访问 /Students/Index路由解析出 controllerStudents、actionIndexMVC 中间件通过依赖注入容器创建 StudentsController 实例构造器里注入的 IStudentService 再由容器创建并注入Action 方法调用 service.GetAll()service 调用 repository.GetAll()repository 使用 ApplicationDbContext 向SQL Server发查询数据返回后组装成 StudentViewModel 列表交给 Index.cshtml 渲染成HTML。关键在于理解异步Action 方法几乎都声明为async TaskIActionResult内部用到await _context.Students.ToListAsync()。EF Core 的异步方法不会阻塞线程池线程这是高并发下保持吞吐量的核心。如果在源码里看到同步写法 .ToList() 而不是 .ToListAsync()建议顺手改掉。这一层的判断标准很简单Controller 里不该出现 new DbContext()Repository 里不该写业务判断。看到这些就说明原代码的封装已经走样了。3. 把 zip 里的 Core 3.1 学生信息源码跑起来解压到端口的五个步骤理论看完了现在进入实际落地环节。目标是在一台干净的 Windows 或 Linux 开发机上把源码跑成一个能访问的网站。3.1 解压并核对运行时版本先解压注意文件名里有空格用引号包裹unzip MF00503-Core 3.1 学生信息源码.zip -d MF00503 cd MF00503 dotnet --list-sdksunzip的 -d 参数指定解压目标目录避免文件散落一地。dotnet --list-sdks输出当前机器上安装的所有 .NET SDK 版本。Core 3.1 项目的目标框架是 netcoreapp3.1需要本机装有 3.1.100 到 3.1.426 之间的 SDK。如果机器上只有 .NET 6 或 .NET 8直接 restore 会报错“目标框架 netcoreapp3.1 不可用”就算手动编辑 csproj 改成 net6.0也未必兼容因为依赖包可能引用了已过时的 API。查看项目文件确认目标框架head -5 MF00503.csprojcsproj 里TargetFrameworknetcoreapp3.1/TargetFramework与 SDK 版本必须对应。建议直接安装 3.1.426 版本这是 Core 3.1 的最终SDK版本之后不会再有小版本更新。装完再执行 dotnet --list-sdks确认出现对应版本号。3.2 配置数据库连接字符串与迁移策略3.2.1 修改 appsettings.json 中的连接字符串{ ConnectionStrings: { DefaultConnection: Server(localdb)\\mssqllocaldb;DatabaseStudentDb;Trusted_ConnectionTrue;MultipleActiveResultSetstrue }, Logging: { LogLevel: { Default: Information, Microsoft: Warning, Microsoft.Hosting.Lifetime: Information } }, AllowedHosts: * }Server(localdb)\\mssqllocaldb是SQL Server Express LocalDB的默认实例名适合开发环境不需要额外安装服务。Trusted_ConnectionTrue表示用Windows身份验证登录。MultipleActiveResultSetstrue允许在同一连接上并行执行多个查询学生列表和详情页经常同时用到多个DbContext查询这个参数建议保留。Production环境里这段配置会被 appsettings.Production.json 覆盖后面第5章会讲。3.2.2 还原依赖并更新数据库dotnet restore dotnet ef database update dotnet rundotnet restore根据 csproj 里的 PackageReference 从 NuGet 下载依赖。dotnet ef database update会把 Migrations 目录下的所有迁移应用到数据库建出学生表、班级表等实体对应的数据表。执行前要确认当前目录下有 Migrations 文件夹并且这个项目引用了Microsoft.EntityFrameworkCore.Design包——否则会报“无法执行此操作因为没有数据库提供程序”这类错误需要手动添加包。3.3 启动后验证网站与数据库运行dotnet run后命令行会输出监听的地址默认是 http://localhost:5000。浏览器访问 /Students/Index正常会出现学生列表页。如果页面报数据库不存在回到命令行执行dotnet ef database update创建库如果报表不存在说明迁移没有包含当前实体结构需要重新生成迁移。3.3.1 常见启动失败的速查表现象原因处理方式HTTP 500 且日志里有“数据库不存在”连接字符串指向了不存在的库实例先启动SQL Server服务或改连接字符串指向已有实例页面样式和图片全部丢失缺少 UseStaticFiles在 Startup.cs 的 UseRouting 前补上app.UseStaticFiles()端口 5000 被占用另一进程正在监听该端口dotnet run --urls http://localhost:8080dotnet ef 命令不存在未安装 EF 工具或未安装 Design 包dotnet tool install --global dotnet-efdotnet run --urls可以临时指定监听端口开发调试时很常用不用改启动配置就能换端口。线上部署通常用 Environment 变量 ASPNETCORE_URLS 来指定监听地址两者的优先级以环境变量为先。端口跑通的标志是能看到 StudentsController 的 Index 页面这证明路由分发正常、依赖注入容器已成功构建、EF Core 能查出数据并完成模型绑定。4. 给 Core 3.1 学生信息源码加一个“籍贯”字段Code First 改动的完整过程跑通之后接得最多的需求是改字段。比如学生表要加“籍贯 NativePlace”下面按 EF Core Code First 的流程走一遍完整改动。如果原项目用的是 DB First从数据库生成模型这段流程要先改成手动改数据库和实体再重新生成模型。4.1 修改实体类与视图模型在 Models/Student.cs 中添加字段using System.ComponentModel.DataAnnotations; namespace MF00503.Models { public class Student { public int Id { get; set; } [Required] [StringLength(50)] public string Name { get; set; } [Required] [StringLength(20)] public string StudentNo { get; set; } // 新增字段 [StringLength(100)] public string NativePlace { get; set; } } }[StringLength(100)]和[Required]都是 System.ComponentModel.DataAnnotations 里自带的数据注解EF Core 会把这些特性映射成数据库列的 NVARCHAR(100) 和 NOT NULL。只给实体加字段但不加注解字段会生成可空列表单验证也不会拦截空值。如果项目里 Controller 直接绑定的是 Student 实体那么表单提交时会自动把同名属性绑定到 NativePlace如果用的是 StudentViewModel需要同步在 ViewModel 里加上这个属性。4.2 生成并执行迁移在项目目录下执行dotnet ef migrations add AddNativePlaceToStudent dotnet ef database updatemigrations add会读取当前实体的状态与上次迁移记录的差异生成一个带有时间戳的迁移类。类里有 Up 和 Down 两个方法Up 是应用本次变更的代码Down 是回滚操作。database update则把所有未应用的迁移按顺序执行到目标数据库。生成的迁移代码大致是这样protected override void Up(MigrationBuilder migrationBuilder) { migrationBuilder.AddColumnstring( name: NativePlace, table: Students, type: nvarchar(100), nullable: true); } protected override void Down(MigrationBuilder migrationBuilder) { migrationBuilder.DropColumn( name: NativePlace, table: Students); }如果项目里没有 Migrations 目录说明原开发者可能用的是 CreateDatabase 的方式建库这时不能直接执行 migrations add。兜底方案是先手动建库再执行下面这条 SQL 把字段加进去ALTER TABLE Students ADD NativePlace NVARCHAR(100) NULL;要查看数据库是否真的更新成功可以用 SQL Server Management Studio 连接连接字符串指定的实例展开表结构确认 NativePlace 列存在。4.3 修改 Razor 视图加入表单控件4.3.1 Create.cshtml 与 Edit.cshtml 中的表单div classform-group label asp-forNativePlace classcontrol-label/label input asp-forNativePlace classform-control / span asp-validation-forNativePlace classtext-danger/span /divasp-for是 Razor 的 Tag Helper 语法它会把生成的 label 的 for 属性、input 的 name 属性和 id 属性都绑定到 Student.NativePlace 上。表单提交时模型绑定器根据 name 属性找到对应的值填充到 Student 实体的 NativePlace 属性里。asp-validation-for生成客户端验证的占位符对应实体上的 [StringLength(100)] 特性会被编译成>th籍贯/th ... tditem.NativePlace/td列表页不加这行不影响功能但用户看不到新录入的数据会以为是代码没生效。4.4 常见的误用只改实体不跑迁移只改 Student.cs不执行 migrations add运行后访问列表页不会报错因为页面查询的是 Select 列表里没有的列。但一旦进入 Create 页面提交新学生EF Core 生成的 INSERT 语句里会包含 NativePlace 列SQL Server 直接抛Invalid column name NativePlace。遇到这个错误时记住实体是代码层的映射数据库列是另一回事两者必须同步。同理手动执行 ALTER TABLE 后没有同步实体EF Core 查询时会忽略新增列不会报错但实体上依然读不到这个字段。这是 DB First 项目最容易踩的坑改完数据库还要回代码里补属性并重新生成模型。整个流程走完后需要再跑一遍添加工、编辑、删除、搜索学生。其中删除页如果调用了FindAsync因为加了字段不影响主键查找但如果列表有搜索框且搜索条件含多个列要检查 Search 方法里的表达式是否包含了字符串拼错的字段名。5. 发布与验收Core 3.1 学生信息系统的上线前检查清单最后一步是发布部署。很多学生项目交付时只给源码和运行说明但实际接手的人需要在服务器上把它变成可执行的网站。5.1 用 publish 输出自包含的部署目录dotnet publish -c Release -o ./publish-c Release是发布配置对应 csproj 里的 Release 条件编译符号-o ./publish指定输出目录。发布完成后publish 文件夹里有 MF00503.dll、MF00503.exeWindows、Views 和 wwwroot。服务器上只需要安装 ASP.NET Core 3.1 Runtime 就能运行不需要 SDK。启动方式在 publish 目录下执行dotnet MF00503.dll默认监听 5000 端口。5.2 用环境配置覆盖连接字符串服务器上的数据库连接不能写在 appsettings.json 里因为在仓库里的文件很容易被多人看到。常见做法是把生产环境配置放进 appsettings.Production.json或用环境变量覆盖。最简单的方案是设置系统环境变量export ConnectionStrings__DefaultConnectionServerprod-db;DatabaseStudentDb;User Idsa;Passwordxxx这个双下划线语法是 Core 3.1 配置体系的标准约定环境变量名ConnectionStrings__DefaultConnection会映射到配置节点 ConnectionStrings:DefaultConnection。该配置优先级高于 appsettings.json所以不用改文件就能切换数据库。5.3 三个核心流程的验证顺序上线前逐项验证先访问学生列表页确认页面正常渲染再新增一条带籍贯字段的记录刷新列表确认显示然后编辑这条记录改掉姓名和学号确认更新成功最后删除它确认没有外键约束卡住。数据库有外键关联选课表时删除会把整条事务失败这时要检查业务规则是提示错误还是级联删除。收尾的一个技巧使用 dotnet ef migrations script 把全部迁移生成一份独立 SQL 文件dotnet ef migrations script -o deploy.sql把 deploy.sql 和 publish 目录一起交给运维或评审老师对方不需要安装 dotnet-ef 工具用 SSMS 执行一次脚本就能把生产库结构准备好。对于 Core 3.1 这种已经停止支持的框架保留一份可执行的 SQL 脚本比依赖 Migration 运行时更新更稳妥因为生产环境装 SDK 的意愿通常很低。发布目录里留一份 deploy.sql后续排查表结构差异时也有据可查。本文还有配套的精品资源点击获取
