現(xiàn)？為什么選擇數(shù)據(jù)庫隔離？)
已發(fā)布的《多租戶架構(gòu)——SaaS 系統(tǒng)的核心能力》講的是什么是多租戶。這篇進(jìn)入實(shí)現(xiàn)層租戶怎么被識(shí)別、數(shù)據(jù)庫怎么被切過去、為什么 EasyAdminBlazor 選擇獨(dú)立數(shù)據(jù)庫而不是TenantId行級(jí)隔離。一、三種隔離方案先擺在一起比做 SaaS 后臺(tái)多租戶數(shù)據(jù)隔離繞不開三條路方案做法優(yōu)點(diǎn)代價(jià)共享庫 TenantId 行級(jí)隔離所有表加TenantId每次查詢都帶租戶條件成本最低、擴(kuò)容簡(jiǎn)單、跨租戶統(tǒng)計(jì)容易漏寫一次WHERE TenantId ?就是數(shù)據(jù)泄露大客戶數(shù)據(jù)混在一起備份恢復(fù)無法按客戶做共享庫 獨(dú)立 Schema每個(gè)租戶一個(gè) schema表結(jié)構(gòu)相同隔離比行級(jí)強(qiáng)仍共享實(shí)例Schema 數(shù)量多時(shí)運(yùn)維復(fù)雜數(shù)據(jù)庫方言差異大MySQL / SQLite 沒有等價(jià) schema 概念獨(dú)立數(shù)據(jù)庫每個(gè)租戶一套庫連接串各自獨(dú)立物理隔離權(quán)限、備份、恢復(fù)、遷移都可按租戶做連接數(shù)和運(yùn)維成本高跨租戶統(tǒng)計(jì)要另行處理EasyAdminBlazor 當(dāng)前采用的是獨(dú)立數(shù)據(jù)庫隔離。這不是一個(gè)更高級(jí)的選擇而是一個(gè)針對(duì)企業(yè)后臺(tái)交付場(chǎng)景的取舍客戶數(shù)量通常有限幾十到幾百但每個(gè)客戶對(duì)數(shù)據(jù)隔離的要求很高而且很多項(xiàng)目本身就是私有化部署 SaaS 混合。源碼里能看到這個(gè)選擇的直接證據(jù)// MultiTenantService.BuildTenantOrmvarfsqlnewFreeSqlBuilder().UseConnectionString(tenantInfo.DataType,tenantInfo.ConenctionString.Replace({database},tenantCode)).UseAdoConnectionPool(true).UseAutoSyncStructure(true).Build();每個(gè)租戶用自己的DataTypeConenctionString{database}占位符會(huì)被租戶編碼替換。也就是說租戶既可以指向同一臺(tái)數(shù)據(jù)庫服務(wù)器上的不同庫也可以指向完全不同的實(shí)例。二、租戶是怎么被識(shí)別的1. 按 Host 識(shí)別MultiTenantService.GetCurrentTenant()用請(qǐng)求的 Host 去主庫匹配publicSysTenant?GetCurrentTenant(){varhttpContext_httpContextAccessor.HttpContext;if(httpContextnull)returnnull;// 每個(gè)請(qǐng)求只解析一次后續(xù)從 HttpContext.Items 緩存讀取if(httpContext.Items.TryGetValue(TenantContextKey,outvarcached)cachedisSysTenantcachedTenant)returncachedTenant;varhosthttpContext.Request.Host.Value;// e.g. localhost:7230if(string.IsNullOrEmpty(host)){httpContext.Items[TenantContextKey]null;returnnull;}// 在 SysTenant 表中查找 Host 匹配的租戶支持完整 URL 或純 host:portvartenant_mainOrm.SelectSysTenant().DisableGlobalFilter().Where(aa.IsEnabled(a.Hosthost||a.Host$https://{host}||a.Host$http://{host})).First();httpContext.Items[TenantContextKey]tenant;returntenant;}幾個(gè)細(xì)節(jié)主庫查詢顯式DisableGlobalFilter()——租戶表本身不能被軟刪除過濾器擋住否則匹配行為會(huì)變得難以預(yù)測(cè)。SysTenant.Host支持三種寫法localhost:7230、https://localhost:7230、http://localhost:7230。開發(fā)環(huán)境用端口區(qū)分生產(chǎn)環(huán)境用域名。每個(gè)請(qǐng)求只查一次結(jié)果放在HttpContext.Items里避免同一次請(qǐng)求內(nèi)反復(fù)查庫。只有IsEnabled true的租戶才會(huì)被解析出來停用租戶等于訪問不到。2. Blazor Server 的特殊處理Blazor Server 的交互回調(diào)里HttpContext可能已經(jīng)不可用了所以AdminContext把租戶解析結(jié)果緩存了一次publicSysTenant?Tenant{get{if(!_tenantResolved){_cachedTenant_tenantService?.GetCurrentTenant();_tenantResolvedtrue;}return_cachedTenant;}}同時(shí)提供了顯式的切換與失效方法publicvoidInvalidateTenantCache(){_tenantResolvedfalse;_cachedTenantnull;}publicvoidSetTenant(SysTenant?tenant){if(tenant!null!IsValidTenantCode(tenant.Code))thrownewArgumentException(租戶編碼不合法,nameof(tenant));varoldCodeTenantCode;_cachedTenanttenant;_tenantResolvedtrue;if(!string.Equals(oldCode,TenantCode,StringComparison.Ordinal)){// 租戶發(fā)生變化權(quán)限/菜單緩存必須重新構(gòu)建Roles[];RoleMenus[];}}切換租戶在普通 Web 請(qǐng)求里很少發(fā)生但 Blazor Server 的 Circuit 生命周期很長不及時(shí)失效就會(huì)一直用舊租戶的數(shù)據(jù)所以這里顯式做了緩存清理。三、數(shù)據(jù)庫是怎么切過去的1. AdminContext.Orm 是唯一入口/// summary/// 獲取 FreeSql 實(shí)例多租戶模式下自動(dòng)切換到租戶數(shù)據(jù)庫。/// /summarypublicIFreeSqlOrmTenant!null?_tenantService!.GetTenantFreeSql(Tenant.Code):_mainOrmHandle.Orm;這一行是整條鏈路的關(guān)鍵沒解析到租戶單庫模式 / 主站→ 用主庫 ORM解析到租戶 → 用該租戶的 FreeSql 實(shí)例?？蚣茏?cè)的IFreeSql是從MainOrmHandle解析出來的 Singleton而多租戶擴(kuò)展會(huì)把FreeSqlCloud注冊(cè)進(jìn)來FreeSqlCloud : FreeSqlCloudstring, IFreeSql由它按租戶編碼返回不同的實(shí)例publicstaticWebApplicationBuilderAddEasyAdminBlazorMultiTenant(thisWebApplicationBuilderbuilder){// 調(diào)用此擴(kuò)展即啟用多租戶無需再設(shè)置 EnableMultiTenant truebuilder.Services.PostConfigureEasyAdminBlazorOptions(oo.EnableMultiTenanttrue);// 關(guān)鍵這里絕對(duì)不能用 builder.Services.BuildServiceProvider() 去提前解析 MainOrmHandle// 那會(huì)創(chuàng)建第二個(gè) DI 容器導(dǎo)致單例被構(gòu)造兩次、生命周期錯(cuò)亂、配置不生效。builder.Services.AddSingleton(sp{varcloudnewFreeSqlCloud();varmainOrmsp.GetRequiredServiceIFreeSql();cloud.Register(main,()mainOrm);returncloud;});// 替換默認(rèn)的 NullTenantService 為 MultiTenantServicebuilder.Services.RemoveAllITenantService();builder.Services.AddSingletonITenantService(spnewMultiTenantService(sp.GetRequiredServiceFreeSqlCloud(),sp.GetRequiredServiceIFreeSql(),sp.GetRequiredServiceIHttpContextAccessor()));returnbuilder;}那段注釋值得讀兩遍不要在注冊(cè)階段BuildServiceProvider()。這會(huì)創(chuàng)建第二個(gè)容器單例被構(gòu)造兩次配置不生效屬于很容易埋進(jìn)去、后期極難排查的坑。2. 誰在主庫誰在租戶庫理解分工比記住 API 更重要數(shù)據(jù)存放位置說明SysTenant租戶清單主庫租戶識(shí)別必須查主庫主站自身的用戶、角色、菜單、業(yè)務(wù)數(shù)據(jù)主庫主租戶編碼固定為main租戶的用戶、角色、菜單、業(yè)務(wù)數(shù)據(jù)租戶庫每個(gè)租戶一套完整的組織、權(quán)限、業(yè)務(wù)表上傳的文件按租戶分目錄wwwroot/uploads/{tenantCode}/yyyy/MM/dd/緩存 / Redis Key按租戶加前綴tenant:{code}:注意第二行主站也是一個(gè)租戶只是它的編碼固定是main。這讓主站 多個(gè)客戶站點(diǎn)可以用同一套代碼。文件目錄隔離來自FileServiceprivatestringTenantPrefix_adminContext.Tenant?.Codeis{}code?${code}/:;緩存隔離來自AdminContextpublicconststringMainTenantCodemain;/// summary/// 統(tǒng)一的多租戶緩存/Redis 鍵前綴格式 tenant:{code}:。/// 所有跨租戶共享的緩存、Redis Key 都必須帶上此前綴避免租戶之間串?dāng)?shù)據(jù)。/// /summarypublicstringTenantCachePrefix$tenant:{TenantCode}:;數(shù)據(jù)庫隔離了但緩存和文件如果不隔離一樣會(huì)串——這一點(diǎn)會(huì)單獨(dú)用一篇文章展開。四、為什么是獨(dú)立數(shù)據(jù)庫1. 收益物理隔離。租戶 A 的數(shù)據(jù)和租戶 B 的數(shù)據(jù)根本不在一個(gè)庫里。即使某處代碼漏寫了租戶過濾條件也查不到別人的數(shù)據(jù)——因?yàn)樗B的是另一個(gè)數(shù)據(jù)庫。這是行級(jí)隔離給不了的安全下限。按租戶運(yùn)維。備份、恢復(fù)、遷移、導(dǎo)出都可以針對(duì)單個(gè)客戶做?？蛻粢盐业臄?shù)據(jù)給我時(shí)直接給一個(gè)庫的備份就是完整交付。連接串可指向不同實(shí)例。SysTenant上有獨(dú)立的DataType和ConenctionString字段名沿用源碼拼寫所以小客戶可以共用一臺(tái)數(shù)據(jù)庫服務(wù)器上的不同庫大客戶可以放到獨(dú)立實(shí)例甚至獨(dú)立機(jī)房私有化部署時(shí)同一個(gè)程序集可以指向客戶自己的數(shù)據(jù)庫。升級(jí)可控。表結(jié)構(gòu)變更可以按租戶灰度出了問題也只影響一個(gè)租戶的庫。2. 代價(jià)連接數(shù)與資源開銷。每個(gè)租戶一套連接池租戶多的時(shí)候數(shù)據(jù)庫連接會(huì)成為瓶頸。源碼用了UseAdoConnectionPool(true)并緩存已構(gòu)建的 FreeSql 實(shí)例避免每個(gè)請(qǐng)求都重新建連。建庫與遷移要做自動(dòng)化。新租戶不能靠人工建表所以必須有自動(dòng)建表能力——這就是下一篇文章的主角AutoSyncStructure?？缱鈶艚y(tǒng)計(jì)變難。所有租戶一共多少訂單這類報(bào)表需要主庫匯總或者額外的數(shù)據(jù)倉庫。框架提供的是運(yùn)行時(shí)隔離不提供跨庫分析能力。數(shù)據(jù)庫數(shù)量上限。MySQL / SQL Server 單實(shí)例的庫數(shù)量有實(shí)際運(yùn)維上限規(guī)?；瘯r(shí)要提前規(guī)劃分片。3. 什么時(shí)候不該選它如果你的場(chǎng)景是免費(fèi)用戶幾萬個(gè)、每個(gè)用戶數(shù)據(jù)量很小獨(dú)立數(shù)據(jù)庫的成本會(huì)遠(yuǎn)高于行級(jí)隔離。多租戶方案沒有銀彈EasyAdminBlazor 選擇的是面向企業(yè)后臺(tái)交付的那條路——它解決的是客戶要求數(shù)據(jù)必須分開這個(gè)更常見的商業(yè)約束。五、落地時(shí)要注意的幾件事1. 租戶編碼是危險(xiǎn)輸入必須白名單租戶編碼會(huì)進(jìn)入數(shù)據(jù)庫名、文件路徑、緩存鍵和 Redis Key。所以框架在入口統(tǒng)一做了校驗(yàn)/// summary/// 租戶編碼白名單字母、數(shù)字、下劃線、短橫線長度 1~50。/// /summary[GeneratedRegex(^[A-Za-z0-9_-]{1,50}$)]privatestaticpartialRegexTenantCodeRegex();publicstaticboolIsValidTenantCode(string?tenantCode){return!string.IsNullOrWhiteSpace(tenantCode)TenantCodeRegex().IsMatch(tenantCode);}測(cè)試?yán)镦i定了這些反例../tenant、tenant/1、tenant\1、tenant;1、tenant;drop、tenant.1、租戶1全部拒絕。租戶保存前也會(huì)再校驗(yàn)一次不合法直接攔住privateasyncTaskOnBeforeSaveAsync(AdminSaveEventArgsSysTenante){e.Item.Codee.Item.Code.Trim().ToLower();if(!AdminContext.IsValidTenantCode(e.Item.Code)){awaitSwalService.Error(CommonLocalizer[租戶編碼只允許字母、數(shù)字、下劃線與短橫線長度 1~50]);e.Canceltrue;}}GetTenantFreeSql內(nèi)部還會(huì)再校驗(yàn)一次形成保存時(shí)校驗(yàn) 使用時(shí)校驗(yàn)的雙重防線。2. 主租戶不允許刪除privateasyncTaskOnBeforeDeleteAsync(AdminRemoveEventArgsSysTenante){foreach(varitemine.Items){if(item.Codemain){awaitSwalService.Error(CommonLocalizer[默認(rèn)租戶不允許刪除]);e.Canceltrue;break;}}...}主庫同時(shí)也是main租戶的數(shù)據(jù)庫刪掉等于把系統(tǒng)自身的管理數(shù)據(jù)刪了。3. 租戶表上不要被軟刪除過濾器擋住GetCurrentTenant用了DisableGlobalFilter()。你自己的租戶相關(guān)查詢?nèi)绻婕败泟h除實(shí)體也要同樣處理否則會(huì)出現(xiàn)租戶明明存在但解析不到的詭異現(xiàn)象。4. 租戶內(nèi)的查詢不要跨到主庫AdminContext.Orm在解析到租戶后返回的是租戶庫。業(yè)務(wù)代碼統(tǒng)一用這個(gè)入口或注入的IFreeSql即可。只有租戶清單、跨租戶統(tǒng)計(jì)這類明確要讀主庫的場(chǎng)景才用MainOrmHandle[Inject]MainOrmHandleMainOrm{get;set;}default!;varallMenusawaitMainOrm.Orm.SelectSysMenu().ToListAsync();Pages/Tenant.razor就是這么做的——它要讀主庫的完整菜單樹再同步到租戶庫。5. 關(guān)閉多租戶時(shí)要有回退路徑框架默認(rèn)注冊(cè)的是NullTenantService它的GetTenantFreeSql會(huì)直接拋異常publicclassNullTenantService:ITenantService{publicSysTenant?GetCurrentTenant()null;publicIFreeSqlGetTenantFreeSql(stringtenantCode)thrownewNotSupportedException(請(qǐng)安裝 EasyAdminBlazor.MultiTenant 擴(kuò)展以啟用多租戶功能);publicTaskListSysMenuGenerateTenantMenus(stringtenantCode)thrownewNotSupportedException(請(qǐng)安裝 EasyAdminBlazor.MultiTenant 擴(kuò)展以啟用多租戶功能);}所以單庫模式下調(diào)用租戶 API 會(huì)立刻報(bào)錯(cuò)而不是靜默拿到主庫——這種顯式失敗比悄悄用錯(cuò)庫安全得多。六、小結(jié)EasyAdminBlazor 的多租戶實(shí)現(xiàn)可以壓縮成四句話識(shí)別按請(qǐng)求 Host 在主庫SysTenant表匹配租戶每個(gè)請(qǐng)求只解析一次。路由AdminContext.Orm根據(jù)是否解析到租戶返回主庫或租戶庫的 FreeSql 實(shí)例。隔離數(shù)據(jù)庫物理隔離文件按{tenantCode}分目錄緩存/Redis Key 加tenant:{code}:前綴。防注入租戶編碼進(jìn)入數(shù)據(jù)庫名/路徑/緩存鍵之前必須過白名單。獨(dú)立數(shù)據(jù)庫帶來的最大代價(jià)是新租戶的表結(jié)構(gòu)必須自動(dòng)建好也就是AutoSyncStructure存在的原因。下一篇專門講它。如果你正在用 .NET 10 Blazor 做多租戶 SaaS 后臺(tái)可以看看 EasyAdminBlazor 的做法獨(dú)立數(shù)據(jù)庫 按域名識(shí)別 菜單/權(quán)限/文件/緩存全鏈路隔離源碼開放可以按自己的商業(yè)模型調(diào)整。文檔https://easyadmin.wang-zhan.com.cn/doc源碼https://gitee.com/gudufy/EasyAdminBlazor ASP.NET Core 多租戶怎么實(shí)現(xiàn)？為什么選擇數(shù)據(jù)庫隔離？
已發(fā)布的《多租戶架構(gòu)——SaaS 系統(tǒng)的核心能力》講的是什么是多租戶。這篇進(jìn)入實(shí)現(xiàn)層租戶怎么被識(shí)別、數(shù)據(jù)庫怎么被切過去、為什么 EasyAdminBlazor 選擇獨(dú)立數(shù)據(jù)庫而不是TenantId行級(jí)隔離。一、三種隔離方案先擺在一起比做 SaaS 后臺(tái)多租戶數(shù)據(jù)隔離繞不開三條路方案做法優(yōu)點(diǎn)代價(jià)共享庫 TenantId 行級(jí)隔離所有表加TenantId每次查詢都帶租戶條件成本最低、擴(kuò)容簡(jiǎn)單、跨租戶統(tǒng)計(jì)容易漏寫一次WHERE TenantId ?就是數(shù)據(jù)泄露大客戶數(shù)據(jù)混在一起備份恢復(fù)無法按客戶做共享庫 獨(dú)立 Schema每個(gè)租戶一個(gè) schema表結(jié)構(gòu)相同隔離比行級(jí)強(qiáng)仍共享實(shí)例Schema 數(shù)量多時(shí)運(yùn)維復(fù)雜數(shù)據(jù)庫方言差異大MySQL / SQLite 沒有等價(jià) schema 概念獨(dú)立數(shù)據(jù)庫每個(gè)租戶一套庫連接串各自獨(dú)立物理隔離權(quán)限、備份、恢復(fù)、遷移都可按租戶做連接數(shù)和運(yùn)維成本高跨租戶統(tǒng)計(jì)要另行處理EasyAdminBlazor 當(dāng)前采用的是獨(dú)立數(shù)據(jù)庫隔離。這不是一個(gè)更高級(jí)的選擇而是一個(gè)針對(duì)企業(yè)后臺(tái)交付場(chǎng)景的取舍客戶數(shù)量通常有限幾十到幾百但每個(gè)客戶對(duì)數(shù)據(jù)隔離的要求很高而且很多項(xiàng)目本身就是私有化部署 SaaS 混合。源碼里能看到這個(gè)選擇的直接證據(jù)// MultiTenantService.BuildTenantOrmvarfsqlnewFreeSqlBuilder().UseConnectionString(tenantInfo.DataType,tenantInfo.ConenctionString.Replace({database},tenantCode)).UseAdoConnectionPool(true).UseAutoSyncStructure(true).Build();每個(gè)租戶用自己的DataTypeConenctionString{database}占位符會(huì)被租戶編碼替換。也就是說租戶既可以指向同一臺(tái)數(shù)據(jù)庫服務(wù)器上的不同庫也可以指向完全不同的實(shí)例。二、租戶是怎么被識(shí)別的1. 按 Host 識(shí)別MultiTenantService.GetCurrentTenant()用請(qǐng)求的 Host 去主庫匹配publicSysTenant?GetCurrentTenant(){varhttpContext_httpContextAccessor.HttpContext;if(httpContextnull)returnnull;// 每個(gè)請(qǐng)求只解析一次后續(xù)從 HttpContext.Items 緩存讀取if(httpContext.Items.TryGetValue(TenantContextKey,outvarcached)cachedisSysTenantcachedTenant)returncachedTenant;varhosthttpContext.Request.Host.Value;// e.g. localhost:7230if(string.IsNullOrEmpty(host)){httpContext.Items[TenantContextKey]null;returnnull;}// 在 SysTenant 表中查找 Host 匹配的租戶支持完整 URL 或純 host:portvartenant_mainOrm.SelectSysTenant().DisableGlobalFilter().Where(aa.IsEnabled(a.Hosthost||a.Host$https://{host}||a.Host$http://{host})).First();httpContext.Items[TenantContextKey]tenant;returntenant;}幾個(gè)細(xì)節(jié)主庫查詢顯式DisableGlobalFilter()——租戶表本身不能被軟刪除過濾器擋住否則匹配行為會(huì)變得難以預(yù)測(cè)。SysTenant.Host支持三種寫法localhost:7230、https://localhost:7230、http://localhost:7230。開發(fā)環(huán)境用端口區(qū)分生產(chǎn)環(huán)境用域名。每個(gè)請(qǐng)求只查一次結(jié)果放在HttpContext.Items里避免同一次請(qǐng)求內(nèi)反復(fù)查庫。只有IsEnabled true的租戶才會(huì)被解析出來停用租戶等于訪問不到。2. Blazor Server 的特殊處理Blazor Server 的交互回調(diào)里HttpContext可能已經(jīng)不可用了所以AdminContext把租戶解析結(jié)果緩存了一次publicSysTenant?Tenant{get{if(!_tenantResolved){_cachedTenant_tenantService?.GetCurrentTenant();_tenantResolvedtrue;}return_cachedTenant;}}同時(shí)提供了顯式的切換與失效方法publicvoidInvalidateTenantCache(){_tenantResolvedfalse;_cachedTenantnull;}publicvoidSetTenant(SysTenant?tenant){if(tenant!null!IsValidTenantCode(tenant.Code))thrownewArgumentException(租戶編碼不合法,nameof(tenant));varoldCodeTenantCode;_cachedTenanttenant;_tenantResolvedtrue;if(!string.Equals(oldCode,TenantCode,StringComparison.Ordinal)){// 租戶發(fā)生變化權(quán)限/菜單緩存必須重新構(gòu)建Roles[];RoleMenus[];}}切換租戶在普通 Web 請(qǐng)求里很少發(fā)生但 Blazor Server 的 Circuit 生命周期很長不及時(shí)失效就會(huì)一直用舊租戶的數(shù)據(jù)所以這里顯式做了緩存清理。三、數(shù)據(jù)庫是怎么切過去的1. AdminContext.Orm 是唯一入口/// summary/// 獲取 FreeSql 實(shí)例多租戶模式下自動(dòng)切換到租戶數(shù)據(jù)庫。/// /summarypublicIFreeSqlOrmTenant!null?_tenantService!.GetTenantFreeSql(Tenant.Code):_mainOrmHandle.Orm;這一行是整條鏈路的關(guān)鍵沒解析到租戶單庫模式 / 主站→ 用主庫 ORM解析到租戶 → 用該租戶的 FreeSql 實(shí)例?？蚣茏?cè)的IFreeSql是從MainOrmHandle解析出來的 Singleton而多租戶擴(kuò)展會(huì)把FreeSqlCloud注冊(cè)進(jìn)來FreeSqlCloud : FreeSqlCloudstring, IFreeSql由它按租戶編碼返回不同的實(shí)例publicstaticWebApplicationBuilderAddEasyAdminBlazorMultiTenant(thisWebApplicationBuilderbuilder){// 調(diào)用此擴(kuò)展即啟用多租戶無需再設(shè)置 EnableMultiTenant truebuilder.Services.PostConfigureEasyAdminBlazorOptions(oo.EnableMultiTenanttrue);// 關(guān)鍵這里絕對(duì)不能用 builder.Services.BuildServiceProvider() 去提前解析 MainOrmHandle// 那會(huì)創(chuàng)建第二個(gè) DI 容器導(dǎo)致單例被構(gòu)造兩次、生命周期錯(cuò)亂、配置不生效。builder.Services.AddSingleton(sp{varcloudnewFreeSqlCloud();varmainOrmsp.GetRequiredServiceIFreeSql();cloud.Register(main,()mainOrm);returncloud;});// 替換默認(rèn)的 NullTenantService 為 MultiTenantServicebuilder.Services.RemoveAllITenantService();builder.Services.AddSingletonITenantService(spnewMultiTenantService(sp.GetRequiredServiceFreeSqlCloud(),sp.GetRequiredServiceIFreeSql(),sp.GetRequiredServiceIHttpContextAccessor()));returnbuilder;}那段注釋值得讀兩遍不要在注冊(cè)階段BuildServiceProvider()。這會(huì)創(chuàng)建第二個(gè)容器單例被構(gòu)造兩次配置不生效屬于很容易埋進(jìn)去、后期極難排查的坑。2. 誰在主庫誰在租戶庫理解分工比記住 API 更重要數(shù)據(jù)存放位置說明SysTenant租戶清單主庫租戶識(shí)別必須查主庫主站自身的用戶、角色、菜單、業(yè)務(wù)數(shù)據(jù)主庫主租戶編碼固定為main租戶的用戶、角色、菜單、業(yè)務(wù)數(shù)據(jù)租戶庫每個(gè)租戶一套完整的組織、權(quán)限、業(yè)務(wù)表上傳的文件按租戶分目錄wwwroot/uploads/{tenantCode}/yyyy/MM/dd/緩存 / Redis Key按租戶加前綴tenant:{code}:注意第二行主站也是一個(gè)租戶只是它的編碼固定是main。這讓主站 多個(gè)客戶站點(diǎn)可以用同一套代碼。文件目錄隔離來自FileServiceprivatestringTenantPrefix_adminContext.Tenant?.Codeis{}code?${code}/:;緩存隔離來自AdminContextpublicconststringMainTenantCodemain;/// summary/// 統(tǒng)一的多租戶緩存/Redis 鍵前綴格式 tenant:{code}:。/// 所有跨租戶共享的緩存、Redis Key 都必須帶上此前綴避免租戶之間串?dāng)?shù)據(jù)。/// /summarypublicstringTenantCachePrefix$tenant:{TenantCode}:;數(shù)據(jù)庫隔離了但緩存和文件如果不隔離一樣會(huì)串——這一點(diǎn)會(huì)單獨(dú)用一篇文章展開。四、為什么是獨(dú)立數(shù)據(jù)庫1. 收益物理隔離。租戶 A 的數(shù)據(jù)和租戶 B 的數(shù)據(jù)根本不在一個(gè)庫里。即使某處代碼漏寫了租戶過濾條件也查不到別人的數(shù)據(jù)——因?yàn)樗B的是另一個(gè)數(shù)據(jù)庫。這是行級(jí)隔離給不了的安全下限。按租戶運(yùn)維。備份、恢復(fù)、遷移、導(dǎo)出都可以針對(duì)單個(gè)客戶做?？蛻粢盐业臄?shù)據(jù)給我時(shí)直接給一個(gè)庫的備份就是完整交付。連接串可指向不同實(shí)例。SysTenant上有獨(dú)立的DataType和ConenctionString字段名沿用源碼拼寫所以小客戶可以共用一臺(tái)數(shù)據(jù)庫服務(wù)器上的不同庫大客戶可以放到獨(dú)立實(shí)例甚至獨(dú)立機(jī)房私有化部署時(shí)同一個(gè)程序集可以指向客戶自己的數(shù)據(jù)庫。升級(jí)可控。表結(jié)構(gòu)變更可以按租戶灰度出了問題也只影響一個(gè)租戶的庫。2. 代價(jià)連接數(shù)與資源開銷。每個(gè)租戶一套連接池租戶多的時(shí)候數(shù)據(jù)庫連接會(huì)成為瓶頸。源碼用了UseAdoConnectionPool(true)并緩存已構(gòu)建的 FreeSql 實(shí)例避免每個(gè)請(qǐng)求都重新建連。建庫與遷移要做自動(dòng)化。新租戶不能靠人工建表所以必須有自動(dòng)建表能力——這就是下一篇文章的主角AutoSyncStructure?？缱鈶艚y(tǒng)計(jì)變難。所有租戶一共多少訂單這類報(bào)表需要主庫匯總或者額外的數(shù)據(jù)倉庫。框架提供的是運(yùn)行時(shí)隔離不提供跨庫分析能力。數(shù)據(jù)庫數(shù)量上限。MySQL / SQL Server 單實(shí)例的庫數(shù)量有實(shí)際運(yùn)維上限規(guī)?；瘯r(shí)要提前規(guī)劃分片。3. 什么時(shí)候不該選它如果你的場(chǎng)景是免費(fèi)用戶幾萬個(gè)、每個(gè)用戶數(shù)據(jù)量很小獨(dú)立數(shù)據(jù)庫的成本會(huì)遠(yuǎn)高于行級(jí)隔離。多租戶方案沒有銀彈EasyAdminBlazor 選擇的是面向企業(yè)后臺(tái)交付的那條路——它解決的是客戶要求數(shù)據(jù)必須分開這個(gè)更常見的商業(yè)約束。五、落地時(shí)要注意的幾件事1. 租戶編碼是危險(xiǎn)輸入必須白名單租戶編碼會(huì)進(jìn)入數(shù)據(jù)庫名、文件路徑、緩存鍵和 Redis Key。所以框架在入口統(tǒng)一做了校驗(yàn)/// summary/// 租戶編碼白名單字母、數(shù)字、下劃線、短橫線長度 1~50。/// /summary[GeneratedRegex(^[A-Za-z0-9_-]{1,50}$)]privatestaticpartialRegexTenantCodeRegex();publicstaticboolIsValidTenantCode(string?tenantCode){return!string.IsNullOrWhiteSpace(tenantCode)TenantCodeRegex().IsMatch(tenantCode);}測(cè)試?yán)镦i定了這些反例../tenant、tenant/1、tenant\1、tenant;1、tenant;drop、tenant.1、租戶1全部拒絕。租戶保存前也會(huì)再校驗(yàn)一次不合法直接攔住privateasyncTaskOnBeforeSaveAsync(AdminSaveEventArgsSysTenante){e.Item.Codee.Item.Code.Trim().ToLower();if(!AdminContext.IsValidTenantCode(e.Item.Code)){awaitSwalService.Error(CommonLocalizer[租戶編碼只允許字母、數(shù)字、下劃線與短橫線長度 1~50]);e.Canceltrue;}}GetTenantFreeSql內(nèi)部還會(huì)再校驗(yàn)一次形成保存時(shí)校驗(yàn) 使用時(shí)校驗(yàn)的雙重防線。2. 主租戶不允許刪除privateasyncTaskOnBeforeDeleteAsync(AdminRemoveEventArgsSysTenante){foreach(varitemine.Items){if(item.Codemain){awaitSwalService.Error(CommonLocalizer[默認(rèn)租戶不允許刪除]);e.Canceltrue;break;}}...}主庫同時(shí)也是main租戶的數(shù)據(jù)庫刪掉等于把系統(tǒng)自身的管理數(shù)據(jù)刪了。3. 租戶表上不要被軟刪除過濾器擋住GetCurrentTenant用了DisableGlobalFilter()。你自己的租戶相關(guān)查詢?nèi)绻婕败泟h除實(shí)體也要同樣處理否則會(huì)出現(xiàn)租戶明明存在但解析不到的詭異現(xiàn)象。4. 租戶內(nèi)的查詢不要跨到主庫AdminContext.Orm在解析到租戶后返回的是租戶庫。業(yè)務(wù)代碼統(tǒng)一用這個(gè)入口或注入的IFreeSql即可。只有租戶清單、跨租戶統(tǒng)計(jì)這類明確要讀主庫的場(chǎng)景才用MainOrmHandle[Inject]MainOrmHandleMainOrm{get;set;}default!;varallMenusawaitMainOrm.Orm.SelectSysMenu().ToListAsync();Pages/Tenant.razor就是這么做的——它要讀主庫的完整菜單樹再同步到租戶庫。5. 關(guān)閉多租戶時(shí)要有回退路徑框架默認(rèn)注冊(cè)的是NullTenantService它的GetTenantFreeSql會(huì)直接拋異常publicclassNullTenantService:ITenantService{publicSysTenant?GetCurrentTenant()null;publicIFreeSqlGetTenantFreeSql(stringtenantCode)thrownewNotSupportedException(請(qǐng)安裝 EasyAdminBlazor.MultiTenant 擴(kuò)展以啟用多租戶功能);publicTaskListSysMenuGenerateTenantMenus(stringtenantCode)thrownewNotSupportedException(請(qǐng)安裝 EasyAdminBlazor.MultiTenant 擴(kuò)展以啟用多租戶功能);}所以單庫模式下調(diào)用租戶 API 會(huì)立刻報(bào)錯(cuò)而不是靜默拿到主庫——這種顯式失敗比悄悄用錯(cuò)庫安全得多。六、小結(jié)EasyAdminBlazor 的多租戶實(shí)現(xiàn)可以壓縮成四句話識(shí)別按請(qǐng)求 Host 在主庫SysTenant表匹配租戶每個(gè)請(qǐng)求只解析一次。路由AdminContext.Orm根據(jù)是否解析到租戶返回主庫或租戶庫的 FreeSql 實(shí)例。隔離數(shù)據(jù)庫物理隔離文件按{tenantCode}分目錄緩存/Redis Key 加tenant:{code}:前綴。防注入租戶編碼進(jìn)入數(shù)據(jù)庫名/路徑/緩存鍵之前必須過白名單。獨(dú)立數(shù)據(jù)庫帶來的最大代價(jià)是新租戶的表結(jié)構(gòu)必須自動(dòng)建好也就是AutoSyncStructure存在的原因。下一篇專門講它。如果你正在用 .NET 10 Blazor 做多租戶 SaaS 后臺(tái)可以看看 EasyAdminBlazor 的做法獨(dú)立數(shù)據(jù)庫 按域名識(shí)別 菜單/權(quán)限/文件/緩存全鏈路隔離源碼開放可以按自己的商業(yè)模型調(diào)整。文檔https://easyadmin.wang-zhan.com.cn/doc源碼https://gitee.com/gudufy/EasyAdminBlazor