NetCore2.2升級到3.1總結-有解無憂

最近公司要求netcore版本從2.2升級到3.1,升級需要修改的配置項和遇到的問題我這邊做一個簡單的總結，

可參考資料：

https://docs.microsoft.com/zh-cn/aspnet/core/migration/22-to-30?view=aspnetcore-5.0&tabs=visual-studio

https://docs.microsoft.com/zh-cn/ef/core/what-is-new/ef-core-3.x/breaking-changes

netcore3.1 下載：

https://dotnet.microsoft.com/download/dotnet/3.1

升級之后使用VS2019以及以上版本哦

一、配置項修改

1. netcore版本修改為3.1

2. Nuget包升級

(1)洗掉包: Microsoft.AspNetCore.App

(2)洗掉包：Microsoft.AspNetCore.Razor.Design

(3)升級包版本：Swashbuckle.AspNetCore 升級到5.0.0及以上

3. Program類修改

IWebHostBuilder 修改為IHostBuilder

代碼如下：

 Microsoft.Extensions.Hosting.Host.CreateDefaultBuilder(args) 
                .ConfigureWebHostDefaults(webBuilder =>
                {

                    webBuilder.UseStartup<Startup>()
                    .ConfigureLogging((hostingContext, logging) =>
                    {
                        logging.AddConsole();
                    })
                    .UseKestrel(op =>
                    {
                        op.ListenAnyIP(5000,
                             listenOptions =>
                             {
                                 listenOptions.Protocols = HttpProtocols.Http1;
                             });
                        op.Limits.MaxRequestBodySize = null;
                    });
                })
            .UseCastleWindsor(HKIocManager.Instance.IocContainer);

View Code

4. Startup類修改：

(1) IHostingEnvironment修改為IWebHostEnvironment

(2) ConfigureServices方法回傳結果由IServiceProvider修改為void

(3) services.AddMvc()修改為 services.AddControllers().AddNewtonsoftJson()

注意：方法名結尾的async會自動取消，

比如：定義的方法名為SearchMemberAsync(),但是在請求方法SearchMemberAsync時提示沒有此方法 ,請求SearchMember方法時卻請求成功

為了方法名結尾不取消async,配置SuppressAsyncSuffixInActionNames引數為false，

代碼如下：

  services.AddControllers(options =>
            {
                options.SuppressAsyncSuffixInActionNames = false;

            }).AddNewtonsoftJson();

View Code

(4) swagger配置修改：

代碼如下：

 services.AddSwaggerGen(options =>
            {
                options.CustomSchemaIds(z => z.FullName);
                options.SwaggerDoc("v1", new OpenApiInfo { Title = "自定義 API", Version = "v1" });
                options.DocInclusionPredicate((s, b) => true);
                options.IncludeXmlComments(Path.Combine(_environment.ContentRootPath, "XMLDocument", "自定義.xml"));
                options.IncludeXmlComments(Path.Combine(_environment.ContentRootPath, "XMLDocument", "自定義.xml"));

                options.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme()
                {
                    Description = "JWT 授權. Example: \"Authorization: Bearer {token}\"",
                    Name = "Authorization",
                    In = ParameterLocation.Header,
                    Type = SecuritySchemeType.ApiKey,
                    Scheme = "bearer",
                    BearerFormat = "JWT"

                });

                options.AddSecurityRequirement(new OpenApiSecurityRequirement
                {
                    {
                          new OpenApiSecurityScheme
                          {
                                Reference = new OpenApiReference
                                {
                                   Id = "Bearer",
                                   Type = ReferenceType.SecurityScheme
                                }
                          },
                           Array.Empty<string>()
                    }

                });

            });

View Code

(5) return services.AddDynamicEF 洗掉return

(6) app.UseMvc修改為app.UseEndpoints

代碼如下：

app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}");
                endpoints.MapControllerRoute("defaultWithArea", "{area}/{controller=Home}/{action=Index}/{id?}");

            });

View Code

(7) 洗掉app.UseDeveloperExceptionPage();

添加app.UseRouting();

5. 視圖:由以前的DbQuery修改為 DbSet

并添加以下配置：

代碼如下：

private void SetDbView(ModelBuilder modelBuilder)
        {          

    modelBuilder.Entity<視圖對應的物體名稱>().ToView("資料庫中視圖名稱");

            /*
             舉例：

             modelBuilder.Entity<VwFilterSku>().HasNoKey().ToView("vw_filter_sku");
             modelBuilder.Entity<VwQuerySku>().HasNoKey().ToView("vw_query_sku");
             */

        }

View Code

6. Map映射問題

使用映射必須在資料源或者映射源上面標記AutoMap特性