部署Blazor应用至Web App后遇数据库驱动无效错误求助

问题概述 #

基于Spark.NET框架开发的Blazor应用本地运行正常，但部署至Azure Web App后触发数据库驱动错误：

Exception: Invalid database driver. Check your .env file and make sure the DB_CONNECTION variable is set to mysql, sqlite, postgres, or sqlserver.
Spark.Library.Database.DatabaseServiceRegistration.AddDatabase(IServiceCollection services, IConfiguration config)

已配置环境变量DB_CONNECTION=sqlserver，Web App运行于.NET 7 64位环境，使用B1应用服务计划。

可能原因与解决步骤 #

1. 验证Web App应用设置的正确性 #

进入Azure门户，导航至目标Web App的配置 > 应用程序设置：

• 确认DB_CONNECTION的取值为sqlserver，无多余空格或拼写错误
• 确保该配置项位于「应用程序设置」区域，而非「连接字符串」区域（Spark.NET默认读取应用级环境变量，连接字符串区域的配置键名格式不兼容）

2. 检查配置加载逻辑 #

在Program.cs中确认配置构建器已包含环境变量源，Spark.NET需同时兼容本地.env文件和Azure环境变量：

var builder = WebApplication.CreateBuilder(args);

// 确保加载Azure Web App注入的环境变量
builder.Configuration.AddEnvironmentVariables();

// 保留本地.env文件加载（用于本地开发）
builder.Configuration.AddDotEnv();

Azure环境变量优先级高于本地.env文件，若未添加AddEnvironmentVariables()，应用将无法读取Web App的配置。

3. 排查配置键的大小写一致性 #

确认代码中读取配置的键名与Web App设置的键名完全一致（如DB_CONNECTION，而非DbConnection或db_connection），部分配置加载逻辑对大小写敏感。

4. 查看实时日志确认配置读取值 #

在Program.cs中添加日志输出，验证应用启动时实际读取的DB_CONNECTION值：

var dbConnValue = builder.Configuration["DB_CONNECTION"];
Console.WriteLine($"Loaded DB_CONNECTION: {dbConnValue ?? "NULL"}");

部署后通过Azure Web App的日志流查看输出，若值为NULL或错误内容，说明配置未被正确读取。

5. 确认数据库驱动包已随应用部署 #

检查项目.csproj文件，确保SQL Server相关驱动包（如Microsoft.Data.SqlClient或Spark.NET依赖的数据库包）未被排除在部署之外：

<PackageReference Include="Microsoft.Data.SqlClient" Version="5.1.1" />
<!-- 避免设置PrivateAssets="All"，否则部署时不会包含该包 -->

本地运行正常不代表部署包包含依赖，需确认部署时所有必要包已被打包上传。

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