这些关键设置没搞好，胡乱升级.NET5的 后果自负！

11月11号是电商狂欢的日子，也是.NET5正式发布的日子，焦急地刷新着微软官网等更新，想第一时间开始折腾。此前Scott Hunter在博客信誓旦旦：.NET Core3.1平滑迁移.NET5，于是当天就去升级了本人的宝藏项目，结果是大坑没有，小坑不断，折腾了一天时间才搞定，下面来仔细捋一捋，给搭建提供点参考。

背景介绍

升级的项目是之前开源在Github上，也曾一周新增300star，后面虽因故关闭了，也算是非常用心的。这不.NET5刚发布，第一时间就开始了升级。

项目是个微信小程序商城，后端是微服务架构支撑的，Ocelot网关+Consul服务注册发现+Core WebApi+gRPC+IdentityServer4都安排上了，整体还是比较复杂的，MongoDB、Redis、RabbitMQ也都安排上了，然后就在.NET Core3.1升级.NET5的过程中，各种踩坑。

VS升级坑

升级的第一个坑来自于VS工具升级！之前.NET5预览版、RC1、RC2都是用的Visual Studio 2019 Preview,这会儿.NET5正式版发现只需要把Visual Studio 2019升级到V16.8即可，然后就兴冲冲的升级去了，结果当头一棒：Visual Studio Installer提示网络未连接无法下载！当然不是网络问题，其实是DNS解析上出了毛病(部分用户会遇到，解决办法是把电脑的DNS设置为8.8.8.8即可)，但毕竟当时是11号凌晨，以为是微软官方同步不够，在选择换工具，直接去Linux下用VS Code升级了，于是就有了下面的第二波环境坑！

经验：如果遇到Visual Studio Installer提示网络未连接无法下载，可以将当前电脑DNS设置为8.8.8.8即可

Linux环境坑

Linux环境下VS Code开发之前都蛮熟悉了，这次想着是升级.NET5，就顺手把Linux系统从CentOS7给换成了CentOS8，然后又华丽丽的各种坑。比如CentOS8中网卡名字从ens33变成了eth0，用nftables替代iptables，各种小变化让人防不胜防，然后docker最新版本的命令也跟之前有些小变化，导致之前整理的Linux+Docker操作笔记各种失灵，来来回回折腾了好几个小时。

当然，环境只是环境，折腾完就过去了，而代码迁移层面的坑才是最麻烦的，因为并不知道还有多少没发现！

.NET5迁移坑坑坑

项目从.NET Core3.1升级到.NET5非常easy，在 global.json 中将SDK版本从3.1升级成5.0，再将TargetFramework从netcoreapp3.1换成net5.0即可。还有部分类库命名空间变化完全没关系，宇宙第一IDE的智能提示轻松解决。但是，在真实项目迁移过程中，我却遇到了各种小问题：

1

Core WebApi框架模板项目中默认集成了swagger，这个是新增的，但之前项目有一些自定义配置和扩展，也导致了冲突。

2

IdentityServer4第三方框架版本升级，API变化很有点多，改动不了不少代码，这个锅虽然不是.NET5的，但也是升级项目会遇到的。

3

尝试C#9花了一些时间，想体验下新语法新特性，如Native ints原生Ints、Pattern matching improvements模式匹配改进版，结果几次把自己绕进去了。

4

项目升级完发现的Bug，DateTime这个天天见的值出现了变化，在 ASP.NET Core 3.1 及更早版本中，DateTime绑定的是服务器本地时间，而5.0之后，DateTime绑定的是UTCTime。