Swagger生成ASP.NET Core WebAPI服务器遇CS0103编译错误求助

我来帮你一步步搞定这个问题，之前我也碰到过Swagger导出的.NET项目出这类状况，按下面的步骤排查修复就行：

先搞定Visual Studio项目加载异常 #

• 清理项目和VS缓存：
  关闭Visual Studio，找到项目根目录下的.vs（隐藏文件夹，得先显示隐藏项）、bin、obj文件夹，全部删掉。然后打开VS的开发者命令提示符，执行 devenv /resetuserdata 重置用户数据，重启VS后再重新加载项目。
• 核对.NET SDK版本：Swagger导出的项目一般会指定特定的.NET版本（比如.NET 6/7/8），你可以打开命令行执行 dotnet --list-sdks 查看本地已安装的SDK，如果缺对应版本，去微软官网下载安装就行。

解决CS0103编译错误（名称在当前上下文不存在） #

这个错误基本是Swagger生成代码时的模板bug，或者你的API定义有不规范的地方，按下面的方式定位修复：

• 先找错误根源：看build.bat输出的详细错误信息，确定到底是哪个类名、枚举值、参数名不存在，比如是某个模型类没生成，还是控制器里引用了一个不存在的类型。
• 检查Swagger API定义：
  打开你用来生成代码的Swagger JSON/YAML文件，排查这些点：
  • 模型的title是否为空，有没有命名冲突；
  • 枚举值有没有特殊字符，定义是否完整；
  • 路径参数和请求体模型的字段是否匹配，$ref引用是否正确。
• 手动修复生成的代码：
  • 如果是缺失模型类，根据Swagger定义里的结构，在项目的Models文件夹下手动补上对应的类；
  • 如果是枚举项缺失，对照Swagger里的枚举定义，在生成的枚举类里补充对应的项；
  • 如果是控制器方法参数类型不对，把参数改成正确的类型，或者补上对应的类型定义。
• 重新导出项目（可选）：要是手动修复太麻烦，回到Swagger UI重新导出，导出时注意选对ASP.NET Core版本，确认“Generate Models”“Generate Controllers”这些选项都勾选正确。

用dotnet命令行先验证构建 #

有时候VS的加载问题是IDE本身的bug，先试试命令行构建，确认项目本身的问题：

• 打开命令提示符，进入项目根目录；
• 执行 dotnet restore 手动还原包，看看有没有包还原失败的提示，要是有，检查NuGet.config里的源是否正常，或者手动添加官方NuGet源；
• 再执行 dotnet build，看详细的错误输出，这样更容易定位问题。

常见的坑点提醒 #

• 可空类型处理：如果Swagger定义里有nullable: true，但生成的代码没加可空标记，可能会导致类型引用错误，手动给对应的字段加上?就行；
• 命名空间冲突：生成的代码可能和本地项目的命名空间冲突，检查项目根命名空间和生成的控制器、模型的命名空间是否一致，不一致的话改成统一的。

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