Blazor Server部署为Windows服务时无法创建SQLite数据库

我开发了一个Blazor Server应用，可对SQLite3数据库进行读写操作。在Visual Studio中运行时一切正常，但部署为Windows服务后，应用无法在本地磁盘创建SQLite数据库。

我的appsettings配置： #

{
    "ConnectionStrings": {
        "MonitorDb": "Data Source=monitor.db"
    },
        "Logging": {
        "LogLevel": {
            "Default": "Information",
            "Microsoft.AspNetCore": "Warning"
        },
        "EventLog": {
            "LogLevel": {
            "Default": "Information"
            }
        }
    },
    "DetailedErrors": true,
    "AllowedHosts": "*",
    "Kestrel": {
        "Endpoints": {
            "Http": {
            "Url": "http://localhost:5100"
            }
        }
    }
}

DbContext类： #

public class ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : DbContext(options)
{
    public DbSet<ConfigurationModel> Configurations { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<ConfigurationModel>().HasData(
            new ConfigurationModel
            {
                Id = 1,
                ClientKey = "1",
                HubAddress = "http://localhost",
                HubPort = "5100",
                HubName = "monitorhub"
            }
        );
        base.OnModelCreating(modelBuilder);
    }
}

Program.cs中创建数据库的代码片段： #

// create database if not exists
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
    dbContext.Database.EnsureCreated();
}

问题原因及解决办法 #

1. 路径问题（最常见） #

Windows服务运行时，默认工作目录是系统目录（通常为C:\Windows\System32），而非应用部署文件夹。此时连接字符串中的monitor.db会指向系统目录，但服务账户没有该目录的写入权限，导致数据库创建失败。

解决方式：
修改连接字符串为应用部署目录的绝对路径，推荐通过代码动态获取：

var appDir = AppContext.BaseDirectory;
var connectionString = $"Data Source={Path.Combine(appDir, "monitor.db")}";
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlite(connectionString));

2. 权限不足 #

Windows服务默认使用LocalSystem、LocalService等系统账户，这类账户对非系统目录的读写权限有限。

解决方式：

• 修改服务登录账户：右键服务→属性→登录选项卡，选择拥有应用部署目录读写权限的账户（如本地管理员或专用服务账户）。
• 手动添加权限：右键应用部署文件夹→属性→安全→编辑→添加，输入服务账户名（如NT AUTHORITY\LocalService），勾选「写入」「修改」权限。

3. 初始化流程验证 #

确保数据库初始化代码正确执行，可添加日志排查：

using (var scope = app.Services.CreateScope())
{
    var logger = scope.ServiceProvider.GetRequiredService<ILogger<Program>>();
    logger.LogInformation("开始创建数据库...");
    var dbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
    try
    {
        dbContext.Database.EnsureCreated();
        logger.LogInformation("数据库创建成功");
    }
    catch (Exception ex)
    {
        logger.LogError(ex, "创建数据库失败");
    }
}

之后在「事件查看器→Windows日志→应用程序」中查看日志，根据报错信息定位具体问题。

内容的提问来源于stack exchange，提问作者Branko Gojković