部署.NET Framework Web应用到Server 2016报CS0117:Encoding无UTF8定义问询

问题解答 #

1. .NET Framework 4.7与.NET 5并行安装问题

两者完全支持在同一台服务器上并行安装运行，属于互相独立的运行时环境，各自承载对应框架开发的应用，不会出现相互干扰的情况。

2. 是否必须安装.NET Framework解决该问题

不是必须，可根据改造成本选择以下两种方案：

• 方案一：在服务器安装对应版本的.NET Framework，直接适配你当前开发的项目版本
• 方案二：将本地项目的目标框架从.NET Framework 4.7.2迁移到.NET 5及以上版本，重新编译发布后即可直接在现有服务器环境运行，无需额外安装.NET Framework

3. .NET 5是否包含Encoding.UTF8定义

.NET 5原生包含Encoding.UTF8的定义。你遇到该报错的核心原因是本地开发的项目基于.NET Framework构建，未做跨框架适配就直接部署到.NET 5运行环境，两个框架的基础类库加载逻辑存在差异，才会触发该异常。如果完成项目框架迁移到.NET 5，现有代码无需任何修改即可正常运行。

补充排查建议 #

可先检查IIS中你部署站点对应的应用程序池配置：

• 若为未迁移的.NET Framework项目，应用程序池的.NET CLR版本需要设置为v4.0.30319
• 若为已经迁移到.NET 5的项目，CLR版本需要设置为无托管代码
  配置错误也会触发类似的类加载异常。

内容的提问来源于stack exchange，提问作者KWallace