Blazor Server发布时如何避免wwwroot中SQLite数据库被覆盖？

核心思路 #

别把生产数据库放在wwwroot或部署会覆盖的目录里——wwwroot是静态资源目录，部署时会被本地发布文件直接替换。应该将生产数据库放到App Service的持久化存储目录，比如%HOME%\site\wwwroot\App_Data或%HOME%\data这类不会被部署操作覆盖的路径。

具体实现步骤 #

1. 分离开发与生产的数据库路径 #

在appsettings.json和appsettings.Production.json中分别配置不同的数据库连接字符串：

• 开发环境（appsettings.json）：

"ConnectionStrings": {
  "SqliteConnection": "Data Source=./LocalDatabase.db"
}

• 生产环境（appsettings.Production.json）：

"ConnectionStrings": {
  "SqliteConnection": "Data Source=%HOME%/site/wwwroot/App_Data/ProductionDatabase.db"
}

2. 确保生产目录存在 #

在应用启动时检查并自动创建生产数据库所在的目录，避免因目录不存在导致数据库初始化失败。在Program.cs中添加以下代码：

var builder = WebApplication.CreateBuilder(args);

// 获取数据库路径并创建目录
var connectionString = builder.Configuration.GetConnectionString("SqliteConnection");
if (!string.IsNullOrEmpty(connectionString))
{
    var dbPath = connectionString.Replace("Data Source=", "");
    var directory = Path.GetDirectoryName(dbPath);
    if (!Directory.Exists(directory))
    {
        Directory.CreateDirectory(directory);
    }
}

// 后续服务注册、中间件配置等代码...

3. 部署时排除本地数据库文件 #

在项目的.csproj文件中添加配置，阻止本地数据库文件被打包到发布包中，从根源避免覆盖生产数据：

<ItemGroup>
  <!-- 排除本地数据库，不参与发布 -->
  <Content Remove="LocalDatabase.db" />
  <None Include="LocalDatabase.db" CopyToPublishDirectory="Never" />
</ItemGroup>

4. 生产数据库初始化（可选） #

如果需要生产环境有基础初始数据，不要直接复制本地数据库，而是用数据迁移或初始化脚本的方式在生产环境首次启动时生成数据。比如用Entity Framework Core的迁移：

# 生成初始化迁移脚本
dotnet ef migrations script -o InitialCreate.sql

部署后可通过App Service的控制台执行脚本，或在应用启动逻辑中自动执行。

额外注意事项 #

• App Service的%HOME%目录是持久化存储，重启、重新部署应用都不会删除该目录下的文件；
• 禁止在wwwroot存储可写的数据库文件，该目录主打静态资源，部分部署模式会直接替换整个目录；
• 定期备份生产数据库，可通过App Service自带的备份功能，或手动脚本备份%HOME%\site\wwwroot\App_Data下的数据库文件。

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