如何在无Swagger包的AspNet Core WebAPI DLL生成Swagger文件？

我目前用Swagger CLI通过以下命令生成Swagger文件：

swagger tofile --output swagger.json MyApi.dll v1

但这个命令要求API DLL里必须包含Swagger包，还要配置：

builder.Services.AddSwaggerGen();

我手头有大量API项目，不想为了生成swagger.json就去修改每个项目添加Swagger包和配置，而且希望能在自动化构建里用命令行完成这个操作。想问下有没有办法用Swagger CLI或者其他工具，从不带Swagger包和相关配置的API DLL生成Swagger文件？

Swagger CLI本身做不到，因为它依赖目标DLL里已经配置好的Swagger生成逻辑。但有几个工具可以直接从.NET API的程序集元数据生成Swagger文档，不需要修改原项目：

• NSwag CLI：这是最常用的替代工具，支持直接分析.NET程序集生成OpenAPI（Swagger）文件。命令示例：

  # 通用.NET程序集生成命令
  nswag openapi2swagger /assembly:MyApi.dll /output:swagger.json
  
  # 针对ASP.NET Core项目的专用命令，能更精准识别路由和特性
  nswag aspnetcoreopenapi /assembly:MyApi.dll /output:swagger.json
  

  它会通过反射读取DLL里的控制器、Action、参数、返回类型等信息，自动生成符合规范的Swagger文档，不需要原项目引用任何Swagger相关包。

• ApiPort：微软官方推出的工具，也支持从.NET程序集生成OpenAPI文档，适合批量处理场景。命令示例：

  apiport generate-openapi --assembly MyApi.dll --output swagger.json
  

• 自定义反射工具：如果上述工具满足不了特殊需求，可以自己写个简单的.NET控制台程序，通过反射加载目标DLL，遍历所有控制器和Action，提取路由规则、参数类型、返回模型等信息，手动构建OpenAPI的JSON结构。这种方式完全可控，适合有定制化需求的场景。

• 运行工具时，要确保目标API DLL的所有依赖程序集都能被找到（比如放在同一目录，或者通过命令参数指定依赖路径）。
• 对于复杂的自定义模型、泛型类型，工具需要访问对应的程序集才能正确生成Schema定义。
• 自动化构建中，可以把这些命令加入CI/CD流程的构建步骤，实现批量生成所有API的Swagger文件。

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