ASP.NET Core中SQLite与Entity Framework Core配置及常见疑问解答

DefaultConnection是配置文件（如appsettings.json）中的键名，并非实际连接字符串。你需要先在配置文件里定义这个键对应的SQLite连接字符串，再通过.NET配置系统读取它。

示例配置（appsettings.json）：

{
  "ConnectionStrings": {
    "DefaultConnection": "Data Source=Konyv.db"
  }
}

对应Program.cs的正确写法：

// 从配置中读取连接字符串
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddDbContext<KonyvDbContext>(options => 
    options.UseSqlite(connectionString));

如果直接写字符串（比如你第二段代码里的"Data source: Konyv.db"），那就是直接传入实际的连接字符串，跳过配置文件读取步骤——这种方式仅适合快速测试，不推荐在正式环境使用。

另外你第二段代码存在语法错误，缺少闭合括号，修正后应为：

builder.Services.AddDbContext<KonyvDbContext>(options => 
    options.UseSqlite(connectionString: "Data Source=Konyv.db"));

• 开发环境：

  • 简单场景可以用appsettings.json，但如果涉及敏感信息（比如带密码的远程SQLite服务），推荐用**.NET Secret Manager**——它会把配置存在本地用户目录，不会被提交到代码仓库。
  • 操作步骤：在项目根目录运行dotnet user-secrets init，再执行dotnet user-secrets set "ConnectionStrings:DefaultConnection" "Data Source=Konyv.db"添加机密。

• 生产环境：

  • 绝对禁止硬编码或存放在代码仓库中，优先使用环境变量——.NET配置系统会自动读取环境变量中的ConnectionStrings__DefaultConnection（双下划线对应JSON的层级结构）。
  • 云环境（如Azure、AWS）建议用对应的密钥管理服务（Azure Key Vault、AWS Secrets Manager），通过配置系统集成读取。
  • 本地生产部署可使用Windows凭据管理器或Linux密钥环存储。

• 优先从配置系统读取连接字符串：避免硬编码，方便不同环境（开发/测试/生产）切换配置。
• 遵循DbContext生命周期规范：AddDbContext默认使用Scoped生命周期，这是EF Core的推荐方式——能保证每个请求的DbContext实例独立，避免并发冲突。
• 适配SQLite特性：
  • 确保应用拥有数据库文件的读写权限，SQLite是文件型数据库，权限不足会导致无法访问。
  • 避免长时间持有DbContext实例，防止文件锁阻塞其他进程访问数据库。
  • 多线程场景开启WAL（Write-Ahead Logging）模式提升并发性能：

    options.UseSqlite(connectionString)
           .UseSqliteOptions(o => o.UseWAL());
    

• 谨慎处理迁移：SQLite对EF Core迁移的支持有限，部分操作（如修改列类型）无法执行。简单场景可使用EnsureCreated替代迁移，复杂场景建议迁移前备份数据库。
• 优先使用异步API：EF Core提供了完整的异步操作方法（如AddAsync、SaveChangesAsync），Web应用中使用可提升吞吐量。
• 开启日志调试：开发环境开启EF Core日志，便于查看生成的SQL语句，排查性能或语法问题：

  builder.Logging.AddFilter("Microsoft.EntityFrameworkCore", LogLevel.Information);
  

• 只读场景禁用跟踪：使用AsNoTracking()减少内存消耗，提升查询速度。

内容的提问来源于stack exchange，提问作者Kornél Géczi