.NET Core Minimal API部署Azure遇HTTP 500及SQLite表不存在问题求助

问题核心 #

SQLite是文件型数据库，Azure App Service部署时本地数据库文件不会同步到云端，且迁移逻辑可能未在云端触发，导致数据库未初始化，进而出现表不存在的500错误。

具体修复步骤 #

• 启动时自动执行迁移或初始化数据库
  在Program.cs中添加初始化逻辑，确保应用启动时自动处理数据库结构：

  var app = builder.Build();
  
  // 数据库初始化逻辑
  using (var scope = app.Services.CreateScope())
  {
      var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
      // 应用所有未执行的迁移（适用于有Migration文件的场景）
      dbContext.Database.Migrate();
      // 若未使用迁移，可直接创建数据库及表（不会应用迁移）
      // dbContext.Database.EnsureCreated();
  }
  
  // 后续API路由配置
  app.Run();
  

  注意：Migrate()依赖已部署的迁移文件，EnsureCreated()仅适合无迁移的Code-First场景，二选一即可。

• 修正SQLite数据库文件路径
  避免使用本地绝对路径，改用Azure App Service的持久化存储路径，防止文件被清理或路径不存在：

  builder.Services.AddDbContext<YourDbContext>(options =>
  {
      // 使用D:\home\data作为持久化存储目录，避免临时目录被清理
      var homeDir = Environment.GetEnvironmentVariable("HOME") ?? string.Empty;
      var dbPath = Path.Combine(homeDir, "data", "your-app-db.db");
      options.UseSqlite($"Data Source={dbPath}");
  });
  

• 确认迁移文件已部署
  通过Azure Portal进入App Service的高级工具（Kudu），打开调试控制台的文件管理器，检查site\wwwroot下是否存在Migrations文件夹及其中的迁移文件。若遗漏，需调整部署配置确保迁移文件被包含在部署包中。

• 验证目录权限
  确保App Service对数据库文件所在目录有读写权限，D:\home\data目录默认具备读写权限，自定义路径需手动确认权限配置。

• 查看详细错误日志
  在Azure Portal的App Service中进入日志->应用程序日志，查看500错误的完整堆栈信息，这能精准定位是迁移执行失败、路径错误还是权限问题。

额外建议 #

• SQLite仅适合低并发场景，若API有较高访问需求，建议替换为Azure SQL Database、Azure Cosmos DB等云原生数据库，规避文件型数据库的持久化和性能瓶颈。
• 部署前可使用Azure App Service本地模拟器，提前验证迁移逻辑和路径配置是否正常。

内容的提问来源于stack exchange，提问作者Manasés Lovera