ASP.NET Core多租户动态连库：报关键字不支持错误的排错与解决

直接触发报错的配置错误 #

你的appsettings.json里TemplateConnection配置存在硬笔误：

• 原配置中Database字段写成了Database==__DBNAME__，连续多写了一个等号
• 这个多余的等号会直接干扰SqlClient的连接字符串解析逻辑，把后续相邻的键值对错误合并为一个无效关键字，最终触发“关键字不支持”的报错

修正方式：删除多余的等号，将TemplateConnection配置改为单等号结构：

"TemplateConnection": "Server=DESKTOP-N41V6ER\\SQLEXPRESS;Database=__DBNAME__;Trusted_Connection=True;MultipleActiveResultSets=true"

服务注册的逻辑冲突问题 #

当前DI容器里存在两个同类型的ApplicationDbContext注册逻辑，会导致解析混乱：

• 首先通过services.AddDbContext<ApplicationDbContext>注册了绑定Master库默认连接的上下文
• 后续又在AddCustomerDbContext扩展方法里手动new了一个绑定租户连接的Scoped上下文实例
  两套注册逻辑没有做隔离，会导致上下文实例解析错乱，极端场景下会拿到默认连接的上下文、或是因为连接字符串构建异常触发报错

修正方式：

1. 删除Startup里最初的默认AddDbContext<ApplicationDbContext>注册逻辑，避免和租户上下文注册冲突
2. 优化AddCustomerDbContext的实现，增加空路径的边界判断，避免URL解析时数组越界：

   public static void AddCustomerDbContext(this IServiceCollection services, IConfiguration configuration)
   {
       services.AddScoped(provider =>
       {
           var httpContext = provider.GetRequiredService<IHttpContextAccessor>();
           // 边界判断，避免请求路径为空时报错
           var pathSegments = httpContext.HttpContext.Request.Path.Value.Split("/", StringSplitOptions.RemoveEmptyEntries);
           if (pathSegments.Length == 0)
           {
               throw new InvalidOperationException("未识别到有效租户标识");
           }
           var clientSlug = pathSegments[0];
           // 读取模板连接字符串，替换数据库占位符
           var templateConn = configuration.GetConnectionString("TemplateConnection");
           var tenantConn = templateConn.Replace("__DBNAME__", $"MultiTenant_{clientSlug}");
           // 构建上下文配置
           var opts = new DbContextOptionsBuilder<ApplicationDbContext>();
           opts.UseSqlServer(tenantConn, s => s.EnableRetryOnFailure())
               .EnableSensitiveDataLogging();
           return new ApplicationDbContext(opts.Options);
       });
   }
   

3. 如果Identity体系需要访问Master库的身份表，建议单独定义一个Master库专用的上下文类型，不要和租户业务库的ApplicationDbContext混用同类型，彻底避免DI解析冲突。

控制器逻辑补全 #

当前GetContacts方法虽然查询了Contact表的数据，但没有把结果传递给视图，会导致即使查询成功，视图也无法渲染列表：

[HttpGet("/{clientName}/contacts")]
public async Task<IActionResult> GetContacts([FromRoute]string clientName)
{
    var contacts = await _db.Contact.ToListAsync();
    // 将查询结果传入视图
    return View(contacts);
}

注意：可以直接用路由参数里的clientName作为租户标识，比手动从URL路径切分的方式更可靠，避免路径解析偏差导致连接字符串拼接错误。

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