.NET Core 3.1中Swashbuckle.AspNetCore.Cli无法加载appsettings.json生成swagger.json

问题核心根因 #

• CLI工具在加载目标项目程序集执行swagger生成逻辑时，不会复刻Web应用正常启动时的默认配置加载全流程：既不会自动按路径识别项目内的appsettings.json、appsettings.{环境名}.json配置文件，也不会自动关联用户机密、环境变量等配置源，所有在Swagger注册流程中直接读取的配置值都会返回null，最终触发未处理的空引用异常。

可落地的解决路径 #

• 路径1：在程序启动入口手动补全配置加载逻辑
  不要完全依赖Host.CreateDefaultBuilder的自动配置加载能力，在Program.cs的主机构建流程中显式声明配置源，兼容CLI工具运行时的路径识别偏移问题：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostContext, configBuilder) =>
        {
            // 手动挂载配置源，关闭配置的变更监听适配CLI场景
            configBuilder.AddJsonFile(
                path: "appsettings.json", 
                optional: true, 
                reloadOnChange: false)
            .AddJsonFile(
                path: $"appsettings.{hostContext.HostingEnvironment.EnvironmentName}.json", 
                optional: true, 
                reloadOnChange: false);
        })
        .ConfigureWebHostDefaults(webBuilder => 
            webBuilder.UseStartup<Startup>());

• 路径2：执行生成命令时显式传入运行时上下文参数
  调用CLI生成命令前，手动设置CLI运行所需的环境变量，明确指定内容根目录、目标环境，避免工具查找配置文件时出现路径偏移：

# Windows PowerShell 执行示例
$env:ASPNETCORE_ENVIRONMENT = "Development"
$env:ASPNETCORE_CONTENT_ROOT = "项目编译输出的dll所在绝对路径"
dotnet swagger tofile --output swagger.json ./你的项目程序集.dll v1

# Linux/macOS 执行示例
export ASPNETCORE_ENVIRONMENT=Development
export ASPNETCORE_CONTENT_ROOT=项目编译输出的dll所在绝对路径
dotnet swagger tofile --output swagger.json ./你的项目程序集.dll v1

• 路径3：在Swagger配置逻辑中增加空值保护
  对Swagger服务注册、Swagger规则配置流程中所有从IConfiguration读取的配置项增加null兜底判断，避免CLI工具加载配置不全时直接触发未处理异常。

额外注意：项目内引用的Swashbuckle.AspNetCore核心包版本，必须和全局/本地安装的Swashbuckle.AspNetCore.Cli工具版本完全一致，跨版本不匹配时也会因为程序集元数据读取异常触发空引用，这类问题和配置加载逻辑无关。

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