将.NET 6 API降级至.NET Core 3时遇到的Visual Studio及配置问题

1. 安装.NET Core 3.x SDK #

VS2022默认不预装.NET Core 3.x这类旧版本SDK，需手动添加：

• 打开VS2022，点击「工具」→「获取工具和功能」，在安装程序的「单个组件」标签下，搜索.NET Core 3.x SDK（推荐选3.1 LTS版本），勾选后完成安装。
• 也可直接下载对应版本的独立SDK安装包进行安装。

2. 创建.NET Core 3.x项目 #

安装SDK后仍找不到创建选项的话：

• 新建项目时，搜索「ASP.NET Core Web API」或对应项目类型，在「框架」下拉菜单中即可看到.NET Core 3.x选项。
• 若仍无选项，可先创建.NET 6项目，再通过修改项目文件切换版本。

3. 修改版本后报错的修复方案 #

直接修改项目属性或csproj文件后报错，大多是依赖不兼容或配置问题，按以下步骤处理：

• 修正csproj配置：打开项目的.csproj文件，将<TargetFramework>值改为netcoreapp3.1（对应你需要的版本），同时移除.NET 6+专属配置（比如<Nullable>enable</Nullable>、<ImplicitUsings>enable</ImplicitUsings>这类节点）。
• 同步NuGet包版本：打开NuGet包管理器，将所有依赖包降级到支持.NET Core 3.x的版本（比如ASP.NET Core相关包需匹配3.1.x版本），避免版本不兼容导致的编译错误。
• 检查服务器运行时：目标IIS服务器必须安装.NET Core 3.x的运行时及ASP.NET Core模块，否则发布后无法启动。
• 清理重建项目：执行「生成」→「清理解决方案」，再「重建解决方案」，清除编译缓存残留问题。

4. IIS发布注意事项 #

• 发布时选择「文件夹」模式，将发布产物复制到IIS站点目录。
• 配置IIS应用程序池时，设置「托管管道模式」为「集成」，「.NET CLR版本」选择「无托管代码」。

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