.NET 6工具发布为dotnet工具后控制台默认日志屏蔽失效问题

核心原因 #

.NET全局工具默认从可执行文件所在目录加载配置文件，你的appsettings.json被打包到了.store下的包关联目录中，与可执行文件路径不匹配；再加上工具可执行文件名和包名不一致，程序无法自动匹配到正确的配置文件路径，导致默认日志配置不生效。

解决方案 #

1. 显式指定配置文件加载路径 #

在程序启动时，通过ConfigurationBuilder手动指定appsettings.json的实际位置，确保程序能找到配置文件。示例代码如下：

var builder = WebApplication.CreateBuilder(args);

// 获取当前程序集的运行路径（可执行文件所在目录）
var execPath = Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location);
// 拼接配置文件路径，替换<你的包名>为实际包名称
var appSettingsFullPath = Path.Combine(execPath, "../../../<你的包名>/appsettings.json");

// 添加指定路径的JSON配置文件
builder.Configuration.AddJsonFile(appSettingsFullPath, optional: false, reloadOnChange: true);

// 将配置绑定到日志系统
builder.Logging.AddConfiguration(builder.Configuration.GetSection("Logging"));

// 后续API构建逻辑...
var app = builder.Build();

可以通过dotnet tool list命令查看工具的安装目录，确认appsettings.json的实际位置，调整路径拼接的层级。

2. 打包时将配置文件输出到可执行文件同目录 #

修改项目的.csproj文件，确保appsettings.json在打包时被复制到工具的可执行目录下，让程序默认就能读取到。添加以下配置：

<ItemGroup>
  <None Update="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <Pack>true</Pack>
    <!-- 路径对应工具的目标框架，如net6.0 -->
    <PackagePath>tools/net6.0/any/</PackagePath>
  </None>
</ItemGroup>

重新打包发布工具后，appsettings.json会和可执行文件处于同一目录，程序启动时会自动加载该配置。

3. 通过环境变量指定配置路径 #

运行工具前，设置环境变量指定配置文件路径，无需修改代码：

# Windows
set DOTNET_CONFIG_FILE=<你的appsettings.json完整路径>
dotnet <工具可执行文件名>

# Linux/macOS
export DOTNET_CONFIG_FILE=<你的appsettings.json完整路径>
dotnet <工具可执行文件名>

或者在启动工具时直接传入配置文件路径参数（需要在程序中读取该参数并加载配置）：

dotnet <工具可执行文件名> --config <appsettings.json路径>

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