You need to enable JavaScript to run this app. VS2019下.Net Core 2.2迁移至3.0(后续升3.1)遭遇404、连接拒绝问题求助
优惠活动
大模型
产品
解决方案
定价
更多

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(),相关配置完全失效。

分步修复操作

  1. 清理服务注册段的冗余代码
    删掉所有重复的MVC、Session、缓存、访问器注册逻辑,仅保留适配带视图MVC项目的单一注册项:
    // 替换原来所有重复的AddMvc/AddControllers/AddRazorPages代码块
    services.AddControllersWithViews(options => options.EnableEndpointRouting = false);
    
    不要叠加多套MVC相关服务,避免路由规则冲突。
  2. 按.NET Core 3.0+要求重写中间件管道顺序
    严格按照执行顺序排列管道中间件,不要混用新旧版本的路由调用逻辑:
    • 保留原有的环境判断逻辑,开发环境开启异常页,生产环境指向错误页
    • 紧接着注册响应压缩中间件app.UseResponseCompression(),让之前配置的Gzip压缩规则生效
    • 依次注册静态文件中间件app.UseStaticFiles()、转发头处理中间件app.UseForwardedHeaders()(对应你之前配置的X-Forwarded-For规则)
    • 注册路由中间件app.UseRouting()
    • 依次注册跨域、身份认证、权限授权中间件
    • 最后注册会话中间件app.UseSession()——注意:会话中间件必须放在需要读取Session的端点之前,不能放在管道最开头
    • 因为已经设置了EnableEndpointRouting = false,直接保留原有的app.UseMvc()路由映射逻辑即可,和参数对齐,不需要再启用新版的端点映射配置。
  3. 排查404、连接拒绝的残留问题
    • 核对launchSettings.json、项目属性中的启动端口,确认应用实际监听的端口和你浏览器访问的端口完全一致,不要残留旧2.2版本的端口配置
    • 确认原有业务控制器(如Cuenta控制器)的目录位置、类名、Login action方法没有被误修改,没有遗漏路由特性标记
    • 修复基础路由后,再逐步把之前裁剪掉的业务依赖加回项目,逐个模块验证功能,避免一次性加回所有依赖引发的偶发问题

后续升级3.1版本的注意事项

  • 从3.0升级到3.1的改动量极小,只需要把项目目标框架从netcoreapp3.0切换为netcoreapp3.1,同步升级对应的NuGet包版本即可,不需要重新调整路由配置
  • 全程不要同时混用旧版IRouter路由和新版端点路由机制,统一使用一种路由模式,避免出现路由匹配优先级异常的问题

内容的提问来源于stack exchange,提问作者luis

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 02:54:03