VS2019下.Net Core 2.2迁移至3.0(后续升3.1)遭遇404、连接拒绝问题求助
.NET Core 2.2 升级3.0/3.1 迁移故障修复指南
核心故障根因(基于提供的Startup.cs代码定位)
你当前遇到的“仅能输出默认hello world、无法匹配原业务路由”“404、连接拒绝”问题,全部是配置逻辑冲突导致的,和业务代码本身无关:
- MVC服务注册完全冲突:代码中先后重复执行
services.AddMvc();、services.AddControllers(options => options.EnableEndpointRouting = false);、services.AddControllersWithViews(options => options.EnableEndpointRouting = false);、两次services.AddRazorPages(),多套路由规则同时注册进DI容器,优先级混乱,默认的内置端点会覆盖你自定义的业务路由,最终触发请求匹配失败。 - 中间件管道顺序违规:.NET Core 3.0+的中间件是按注册顺序串行执行的,当前代码里重复调用两次
app.UseSession()放在管道最开头,之后跳过了必须的顺序校验直接调用旧版2.2兼容的app.UseMvc(),和新版内置的端点路由机制产生冲突,导致路由注册失效。 - 服务注册冗余无实际作用:代码中重复注册了两次
AddMemoryCache()、两次AddSession()、两次AddHttpContextAccessor,虽然不会直接触发404,但会造成DI容器解析异常,偶发请求无响应;注册了Gzip响应压缩的服务,却从未在管道中调用app.UseResponseCompression(),相关配置完全失效。
分步修复操作
- 清理服务注册段的冗余代码
删掉所有重复的MVC、Session、缓存、访问器注册逻辑,仅保留适配带视图MVC项目的单一注册项:
不要叠加多套MVC相关服务,避免路由规则冲突。// 替换原来所有重复的AddMvc/AddControllers/AddRazorPages代码块 services.AddControllersWithViews(options => options.EnableEndpointRouting = false); - 按.NET Core 3.0+要求重写中间件管道顺序
严格按照执行顺序排列管道中间件,不要混用新旧版本的路由调用逻辑:- 保留原有的环境判断逻辑,开发环境开启异常页,生产环境指向错误页
- 紧接着注册响应压缩中间件
app.UseResponseCompression(),让之前配置的Gzip压缩规则生效 - 依次注册静态文件中间件
app.UseStaticFiles()、转发头处理中间件app.UseForwardedHeaders()(对应你之前配置的X-Forwarded-For规则) - 注册路由中间件
app.UseRouting() - 依次注册跨域、身份认证、权限授权中间件
- 最后注册会话中间件
app.UseSession()——注意:会话中间件必须放在需要读取Session的端点之前,不能放在管道最开头 - 因为已经设置了
EnableEndpointRouting = false,直接保留原有的app.UseMvc()路由映射逻辑即可,和参数对齐,不需要再启用新版的端点映射配置。
- 排查404、连接拒绝的残留问题
- 核对
launchSettings.json、项目属性中的启动端口,确认应用实际监听的端口和你浏览器访问的端口完全一致,不要残留旧2.2版本的端口配置 - 确认原有业务控制器(如Cuenta控制器)的目录位置、类名、Login action方法没有被误修改,没有遗漏路由特性标记
- 修复基础路由后,再逐步把之前裁剪掉的业务依赖加回项目,逐个模块验证功能,避免一次性加回所有依赖引发的偶发问题
- 核对
后续升级3.1版本的注意事项
- 从3.0升级到3.1的改动量极小,只需要把项目目标框架从
netcoreapp3.0切换为netcoreapp3.1,同步升级对应的NuGet包版本即可,不需要重新调整路由配置 - 全程不要同时混用旧版IRouter路由和新版端点路由机制,统一使用一种路由模式,避免出现路由匹配优先级异常的问题
内容的提问来源于stack exchange,提问作者luis
相关产品推荐
相关产品推荐

