PowerBI.Api包与ASP.NET Core是否兼容？迁移遇框架版本警告

你遇到的这个警告其实是个关键信号——你装的Microsoft.PowerBI.Api 2.0.11是针对.NET Framework开发的老版本，完全不支持.NET Core，虽然编译时只是警告，但运行时大概率会出各种奇怪的兼容性问题，必须马上处理。

下面是一步步的解决办法：

1. 卸载旧的不兼容包 #

先把项目里的Microsoft.PowerBI.Api 2.0.11彻底卸载掉，不管是通过NuGet包管理器还是命令行：

Uninstall-Package Microsoft.PowerBI.Api

2. 安装适配.NET Core的新版PowerBI包 #

微软后来推出了专门支持.NET Core/.NET 5+的PowerBI SDK，你需要安装以下几个核心包：

• 主API包：Microsoft.PowerBI.Api（选v3.x及以上版本，现在最新稳定版是v5.x）
• ASP.NET Core适配包：Microsoft.PowerBI.Api.AspNetCore（帮你快速集成依赖注入）
• 身份验证包：Microsoft.Identity.Client（用于获取PowerBI嵌入令牌，替代旧版的ADAL）

用NuGet命令行安装的话：

Install-Package Microsoft.PowerBI.Api -Version 5.2.0
Install-Package Microsoft.PowerBI.Api.AspNetCore
Install-Package Microsoft.Identity.Client

3. 调整代码适配新版API #

旧版的PowerBIClient创建方式在.NET Core里已经不适用了，新版推荐用依赖注入来注册客户端，比如在Program.cs（.NET 6+）里：

var builder = WebApplication.CreateBuilder(args);

// 注册PowerBIClient
builder.Services.AddPowerBIClient(config =>
{
    config.AuthenticationMode = Microsoft.PowerBI.Api.Models.AuthenticationMode.App;
    config.ClientId = builder.Configuration["PowerBI:ClientId"];
    config.ClientSecret = builder.Configuration["PowerBI:ClientSecret"];
    config.TenantId = builder.Configuration["PowerBI:TenantId"];
});

var app = builder.Build();
// ... 其他中间件配置

然后在控制器里注入使用：

private readonly IPowerBIClient _powerBiClient;

public PowerBiController(IPowerBIClient powerBiClient)
{
    _powerBiClient = powerBiClient;
}

public async Task<IActionResult> EmbedReport()
{
    // 获取报表嵌入配置
    var workspaceId = Guid.Parse(builder.Configuration["PowerBI:WorkspaceId"]);
    var reportId = Guid.Parse(builder.Configuration["PowerBI:ReportId"]);
    
    var embedToken = await _powerBiClient.EmbedToken.GenerateTokenAsync(
        workspaceId,
        reportId,
        new Microsoft.PowerBI.Api.Models.GenerateTokenRequestV2(
            accessLevel: Microsoft.PowerBI.Api.Models.TokenAccessLevel.View
        )
    );

    var model = new EmbedReportViewModel
    {
        ReportId = reportId.ToString(),
        EmbedUrl = $"https://app.powerbi.com/reportEmbed?reportId={reportId}&groupId={workspaceId}",
        EmbedToken = embedToken.Token
    };

    return View(model);
}

4. 确认项目目标框架 #

确保你的ASP.NET Core项目目标框架是.NET Core 3.1及以上（推荐用.NET 6或更高版本），新版本的PowerBI包不再支持低于3.1的.NET Core版本。

为什么会出现这个警告？ #

旧版的Microsoft.PowerBI.Api 2.0.11是2017年左右的版本，那时候.NET Core还没普及，微软还没推出适配的SDK。当你在.NET Core项目里安装这个包时，NuGet只能用.NET Framework的版本来恢复，就会弹出这个兼容性警告，后续运行时可能会遇到缺失API、权限问题等各种坑。

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