在.NET Framework自托管OWIN WebAPI集成Microsoft Entra遇空引用异常

问题根源在于OwinTokenAcquirerFactory默认依赖ASP.NET的HttpContext获取配置文件路径，但Windows服务启动阶段不存在HttpContext，导致访问HttpContext.Current.Request.PhysicalApplicationPath时抛出空引用异常。以下是可行的解决方法：

1. 手动构建配置实例，绕过HttpContext依赖 #

不要使用TokenAcquirerFactory.GetDefaultInstance<OwinTokenAcquirerFactory>()，而是手动创建工厂实例并指定配置来源，彻底规避对HttpContext的依赖。

示例代码：

public void ConfigureAuth(IAppBuilder app)
{
    // 从服务运行目录加载appsettings.json配置
    var configBuilder = new ConfigurationBuilder()
        .SetBasePath(AppDomain.CurrentDomain.BaseDirectory)
        .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

    IConfiguration configuration = configBuilder.Build();

    // 手动初始化TokenAcquirerFactory并传入配置
    var tokenAcquirerFactory = new OwinTokenAcquirerFactory(configuration);
    tokenAcquirerFactory.Services.AddMicrosoftIdentityWebApiAuthentication(configuration);

    app.UseAuthentication();
    app.UseWebApi(config);
}

2. 自定义OwinTokenAcquirerFactory，重写配置逻辑 #

如果需要更灵活的配置加载逻辑，可以继承OwinTokenAcquirerFactory并重写DefineConfiguration方法，直接使用服务的基础路径加载配置：

public class CustomOwinTokenAcquirerFactory : OwinTokenAcquirerFactory
{
    public CustomOwinTokenAcquirerFactory(IConfiguration configuration) : base(configuration)
    {
    }

    protected override void DefineConfiguration(IConfigurationBuilder builder)
    {
        // 直接使用服务运行目录作为配置根路径，完全绕过HttpContext
        builder.SetBasePath(AppDomain.CurrentDomain.BaseDirectory)
               .AddJsonFile("appsettings.json", optional: false);
    }
}

// 在Startup中使用自定义工厂
public void ConfigureAuth(IAppBuilder app)
{
    var configBuilder = new ConfigurationBuilder()
        .SetBasePath(AppDomain.CurrentDomain.BaseDirectory)
        .AddJsonFile("appsettings.json");

    var configuration = configBuilder.Build();
    var tokenAcquirerFactory = new CustomOwinTokenAcquirerFactory(configuration);
    
    tokenAcquirerFactory.Services.AddMicrosoftIdentityWebApiAuthentication(configuration);
    app.UseAuthentication();
    app.UseWebApi(config);
}

3. 确保配置文件正确部署 #

• 右键项目中的appsettings.json，设置复制到输出目录为“始终复制”或“如果较新则复制”，保证Windows服务运行时能在安装目录下找到配置文件。
• 确认服务运行账户拥有读取配置文件所在目录的权限。

额外注意事项 #

• 检查appsettings.json中的Entra ID配置项（AzureAd:TenantId、AzureAd:ClientId等）是否准确。
• Windows服务启动时，AppDomain.CurrentDomain.BaseDirectory指向服务可执行文件所在目录，不要依赖相对路径读取配置。

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