.NET 6单文件Windows服务如何设置正确的内容根路径？

核心问题原因 #

单文件自包含应用运行时会被自动解压到系统临时目录，默认内容根路径会指向这个临时目录，导致无法读取exe所在目录的appsettings.json。即便通过--contentRoot参数指定路径，也可能因服务启动上下文问题未生效，最可靠的方式是在代码中强制指定内容根路径。

解决方案步骤 #

1. 在Program.cs中手动指定内容根路径 #

通过获取当前可执行文件的真实路径，计算出其所在目录，以此作为内容根路径：

using System.Diagnostics;
using System.IO;

var exePath = Process.GetCurrentProcess().MainModule.FileName;
var contentRoot = Path.GetDirectoryName(exePath);

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    Args = args,
    ContentRootPath = contentRoot
});

// 后续配置代码保持原有逻辑即可
builder.Services.AddControllers();
// ...其他服务注册代码

var app = builder.Build();
// ...中间件配置代码
app.Run();

2. 确保配置文件被正确发布到exe目录 #

在项目的.csproj文件中添加以下配置，保证appsettings.json会被复制到发布目录：

<ItemGroup>
    <None Update="appsettings.json">
        <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
</ItemGroup>

3. 创建Windows服务（可选优化） #

如果代码中已经指定了内容根路径，创建服务时可以省略--contentRoot参数，避免冲突。示例命令：

sc create MyApiService binPath= "C:\Deploy\MyApi.exe" DisplayName= "My .NET 6 API Service"

若仍需手动指定参数，确保使用绝对路径：

sc create MyApiService binPath= "C:\Deploy\MyApi.exe --contentRoot C:\Deploy" DisplayName= "My .NET 6 API Service"

验证方法 #

启动服务后，可添加日志输出内容根路径确认是否正确：

builder.Logging.AddConsole();
var logger = builder.Services.BuildServiceProvider().GetRequiredService<ILogger<Program>>();
logger.LogInformation("Content Root Path: {Path}", builder.Environment.ContentRootPath);

查看Windows事件日志或控制台输出，验证路径是否指向exe所在目录。

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