PAYATHON 2026

EF Core 10.0.11/12 升级后 Azure Function 本地 AD Interactive 调试失败

数据小陈

先说结论

把 Microsoft.EntityFrameworkCore.* 升到 10.0.11/12 后,EF Core 查询本身没变,变的是传递依赖里的 Microsoft.Data.SqlClient/MSAL 身份验证链。Authentication=Active Directory Interactive 在 Windows 上走 WAM 时需要父窗口句柄,而 Azure Functions Core Tools 的 worker 进程拿不到可用的窗口句柄,于是直接抛出 0xwindow_handle_required,浏览器登录窗口也不会弹出来。10.0.10 还能用,通常是因为它解析到的 Microsoft.Data.SqlClient 版本还没有默认走这套 WAM 交互流程。

先检查传递依赖

在项目目录执行:

dotnet list package --include-transitive

对比 EF Core 10.0.10 和 10.0.11/12 下 Microsoft.Data.SqlClient、Microsoft.Identity.Client 等包有没有变化。如果 10.0.11/12 把 Microsoft.Data.SqlClient 提到了新版本,基本就能对上这个现象。

推荐方案:本地改用 Active Directory Default

本地调试不用再使用 Active Directory Interactive,改成 Active Directory Default,让 SqlClient 使用开发者登录凭据。先登录:

az login
az account set --subscription <subscription-id>

本地连接字符串改成:

Server=azure_server_name.database.windows.net;Database=azure_database_name;Authentication=Active Directory Default;Encrypt=True;

DefaultAzureCredential 也能使用 Visual Studio 里已登录的账号。数据库这边还要给这个账号授权,例如:

CREATE USER [user@contoso.com] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [user@contoso.com];
ALTER ROLE db_datawriter ADD MEMBER [user@contoso.com];

生产环境继续用 Managed Identity:

Server=azure_server_name.database.windows.net;Database=azure_database_name;Authentication=Active Directory Managed Identity;User Id=<user-assigned-client-id>;

系统分配的托管标识可以省略 User Id。

备选方案:Device Code Flow

如果必须走交互式登录,可以试试:

Server=azure_server_name.database.windows.net;Database=azure_database_name;Authentication=Active Directory Device Code Flow;User Id=<upn>;

运行后按控制台提示,在浏览器里输入设备代码。能不能用,取决于当前 Microsoft.Data.SqlClient 版本是否支持 Device Code Flow。

备选方案:固定 Microsoft.Data.SqlClient 版本

如果确认 10.0.10 用的是 Microsoft.Data.SqlClient 6.1.1,可以在项目里显式固定:

<ItemGroup>
  <PackageReference Include='Microsoft.Data.SqlClient' Version='6.1.1' />
</ItemGroup>

使用中央包管理时:

<PackageVersion Include='Microsoft.Data.SqlClient' Version='6.1.1' />

然后执行:

dotnet restore
dotnet list package --include-transitive

确认解析结果回到 6.1.1。如果出现 NU1605 降级警告,说明新版 EF Core 对这个依赖有更高要求。这种情况下优先用 Active Directory Default,或者暂时留在 EF Core 10.0.10。

不建议在 Functions Core Tools 里强行补窗口句柄

WithParentActivityOrWindow 这类做法适用于自己创建 MSAL PublicClientApplication 的桌面程序。Azure Functions Core Tools 的认证发生在 SqlClient 内部,连接字符串里也没有直接传入父窗口句柄的选项。所以不要指望在 Function 代码里补一个窗口句柄就能稳定解决。

注意事项

  • Active Directory Interactive 适合桌面程序,不适合没有 UI 的 Function Host/worker。
  • 本地凭据要有 Azure SQL 数据库的访问权限;否则换了认证方式后,登录可能成功,查询仍然失败。
  • 如果用 DefaultAzureCredential 拿到访问令牌再赋给 SqlConnection.AccessToken,要注意令牌过期和连接池复用问题。本地调试可以这样做,长期运行建议使用连接拦截器,或者重新获取令牌。
  • 升级 EF Core 后先看传递依赖,不要只盯着 EF Core 本身的版本号。

备注:内容仅供参考。