簡(jiǎn)介這份資源是一套基于C#與ASP.NET構(gòu)建的完整企業(yè)后臺(tái)管理系統(tǒng)源碼面向具備一定.NET基礎(chǔ)、希望深入理解B/S架構(gòu)企業(yè)級(jí)應(yīng)用開發(fā)的開發(fā)者與學(xué)習(xí)者。系統(tǒng)采用Visual Studio 2012開發(fā)涵蓋用戶管理、權(quán)限控制、數(shù)據(jù)報(bào)表、流程審批等典型模塊并附數(shù)據(jù)庫(kù)建表腳本與字段說(shuō)明便于理解數(shù)據(jù)模型與業(yè)務(wù)邏輯。壓縮包共909個(gè)文件約104.86MB以190個(gè)cs源碼、168個(gè)dll程序集、103個(gè)xml配置、73個(gè)js腳本、65個(gè)cshtml視圖及22個(gè)css樣式為主另含sql腳本、csproj工程文件與sln解決方案完整呈現(xiàn)項(xiàng)目分層結(jié)構(gòu)。目前已有2298人學(xué)習(xí)下載。通過(guò)研讀源碼與數(shù)據(jù)庫(kù)設(shè)計(jì)讀者可掌握ASP.NET MVC分層開發(fā)、權(quán)限映射、緩存優(yōu)化、異常處理與日志記錄等實(shí)踐思路是學(xué)習(xí)企業(yè)后臺(tái)系統(tǒng)架構(gòu)與二次開發(fā)的實(shí)用素材。1. 從零搭一套 C# 企業(yè)后臺(tái)管理系統(tǒng)先想清楚它到底管什么很多人搜「C#完整的企業(yè)后臺(tái)管理系統(tǒng)」腦子里想的是找一份能直接跑起來(lái)的源碼解壓、改連接字符串、F5然后登錄進(jìn)去看到菜單樹和用戶列表。但真做過(guò)交付的人都知道后臺(tái)管理系統(tǒng)從來(lái)不是「一套代碼」而是一組能力的集合身份認(rèn)證、權(quán)限模型、組織架構(gòu)、字典配置、日志審計(jì)、定時(shí)任務(wù)、文件管理、數(shù)據(jù)導(dǎo)入導(dǎo)出。這些能力在任何一個(gè)企業(yè)項(xiàng)目里都會(huì)重復(fù)出現(xiàn)所以才會(huì)有人想把它沉淀成一套可復(fù)用的底座。這篇文章不講某一份具體源碼怎么改而是按一線交付的路徑把「用 C# 搭一套企業(yè)后臺(tái)管理系統(tǒng)」這件事拆開技術(shù)棧怎么選、權(quán)限模型怎么設(shè)計(jì)、數(shù)據(jù)訪問(wèn)層怎么寫、前后端怎么對(duì)接、部署和排錯(cuò)怎么做。適合兩類人一類是剛?cè)腴T C#、想通過(guò)一個(gè)完整項(xiàng)目把語(yǔ)言特性和工程實(shí)踐串起來(lái)的新手另一類是做過(guò)多套業(yè)務(wù)系統(tǒng)、想整理一套自己團(tuán)隊(duì)底座的老手。讀完你應(yīng)該能判斷這套方案值不值得投入以及第一步該動(dòng)哪里。2. 技術(shù)選型.NET 版本、ORM 與前端形態(tài)怎么定2.1 后端框架與 .NET 版本的選擇理由企業(yè)后臺(tái)管理系統(tǒng)的后端絕大多數(shù)場(chǎng)景下我會(huì)選 ASP.NET Core Web API而不是 MVC 帶 Razor 頁(yè)面。原因很直接后臺(tái)系統(tǒng)通常要同時(shí)服務(wù) Web 端、可能的桌面客戶端比如 C# 上位機(jī)、WinForm 工具和移動(dòng)端審批接口層獨(dú)立出來(lái)復(fù)用性最高。Razor Pages 適合純服務(wù)端渲染的中小型后臺(tái)但一旦前端要換成 Vue 或 React接口就得重寫一遍。.NET 版本上新項(xiàng)目直接上 .NET 8 的 LTS。別再用 .NET Framework 4.x 起新項(xiàng)目了除非你要對(duì)接的第三方庫(kù)比如某些老的金蝶云客戶端組件、老版本大恒相機(jī) SDK只有 Framework 版本。.NET 8 在性能、容器化、跨平臺(tái)部署上的優(yōu)勢(shì)是實(shí)打?qū)嵉腟ystem.Text.Json的源生成器對(duì)接口序列化性能提升明顯。一個(gè)常見的糾結(jié)是要不要用 ABP Framework 這類重型框架我的經(jīng)驗(yàn)是團(tuán)隊(duì)小于 5 人、業(yè)務(wù)不復(fù)雜時(shí)ABP 的學(xué)習(xí)成本和約定約束反而拖慢進(jìn)度團(tuán)隊(duì)大、模塊多、需要多租戶時(shí)ABP 的模塊化和依賴注入體系能省很多重復(fù)設(shè)計(jì)。中間路線是自己搭一套輕量分層下面會(huì)給結(jié)構(gòu)。2.2 ORM 選型EF Core 還是 Dapper這是被問(wèn)得最多的問(wèn)題。我的判斷標(biāo)準(zhǔn)是寫操作復(fù)雜、領(lǐng)域模型重的用 EF Core讀多寫少、報(bào)表查詢多的用 Dapper 補(bǔ)位。實(shí)際項(xiàng)目里兩者共存是最舒服的。EF Core 的優(yōu)勢(shì)是變更跟蹤、遷移、LINQ 查詢適合用戶、角色、權(quán)限這類關(guān)系明確的實(shí)體。但后臺(tái)系統(tǒng)里總有幾個(gè)「列表頁(yè)要 join 七八張表還要分頁(yè)排序」的查詢用 EF Core 寫出來(lái)要么性能差要么表達(dá)式樹繞到看不懂。這種查詢我直接用 Dapper 寫 SQL返回 DTO。// 混合用法寫操作走 EF Core復(fù)雜查詢走 Dapper public class UserService { private readonly AppDbContext _db; // EF Core 上下文 private readonly IDbConnection _conn; // Dapper 用的連接 public UserService(AppDbContext db, IDbConnection conn) { _db db; _conn conn; } // 寫EF Core 負(fù)責(zé)變更跟蹤和事務(wù) public async Task CreateAsync(User user) { _db.Users.Add(user); await _db.SaveChangesAsync(); } // 讀復(fù)雜聯(lián)表查詢用 DapperSQL 可控、性能可預(yù)期 public async TaskIEnumerableUserListDto QueryListAsync(int page, int size) { const string sql SELECT u.Id, u.UserName, r.RoleName, d.DeptName FROM Users u LEFT JOIN UserRoles ur ON ur.UserId u.Id LEFT JOIN Roles r ON r.Id ur.RoleId LEFT JOIN Departments d ON d.Id u.DeptId WHERE u.IsDeleted 0 ORDER BY u.Id DESC OFFSET Offset ROWS FETCH NEXT Size ROWS ONLY; return await _conn.QueryAsyncUserListDto(sql, new { Offset (page - 1) * size, Size size }); } }參數(shù)說(shuō)明Offset和Size是分頁(yè)參數(shù)SQL Server 2012 以上支持OFFSET...FETCH如果數(shù)據(jù)庫(kù)是 MySQL改成LIMIT Size OFFSET Offset。注意 Dapper 的連接要和 EF Core 用同一個(gè)連接字符串事務(wù)邊界要統(tǒng)一否則會(huì)出現(xiàn)「EF 提交了、Dapper 沒(méi)提交」的臟數(shù)據(jù)。2.3 前端形態(tài)分離還是服務(wù)端渲染后臺(tái)系統(tǒng)的前端2024 年之后我基本不再推薦純 Razor 了。Vue 3 Element Plus 或 React Ant Design 是主流接口用 Web API。理由后臺(tái)系統(tǒng)的表格、表單、彈窗交互密集組件庫(kù)能省掉大量手寫 DOM 的活。如果你團(tuán)隊(duì)只有 C# 背景、沒(méi)有前端那退一步用 Blazor Server 也能接受但要注意 Blazor Server 依賴長(zhǎng)連接網(wǎng)絡(luò)抖動(dòng)時(shí)體驗(yàn)會(huì)掉。選型沒(méi)有絕對(duì)對(duì)錯(cuò)關(guān)鍵是別在項(xiàng)目中期換前端形態(tài)。我見過(guò)一個(gè)項(xiàng)目先用 Razor 寫了三個(gè)月后來(lái)要接移動(dòng)端被迫把頁(yè)面邏輯全部重寫成接口血淚經(jīng)驗(yàn)。3. 權(quán)限模型與數(shù)據(jù)庫(kù)設(shè)計(jì)RBAC 落地時(shí)最容易含糊的地方3.1 RBAC 三張表還是五張表后臺(tái)系統(tǒng)的權(quán)限標(biāo)準(zhǔn)做法是 RBAC基于角色的訪問(wèn)控制。最簡(jiǎn)模型是三張表用戶、角色、用戶角色關(guān)聯(lián)。但企業(yè)系統(tǒng)里通常要五張用戶、角色、權(quán)限菜單/按鈕、角色權(quán)限關(guān)聯(lián)、用戶角色關(guān)聯(lián)。區(qū)別在于「權(quán)限」這一層要不要獨(dú)立成表。我的建議是獨(dú)立。因?yàn)楹笈_(tái)系統(tǒng)的權(quán)限粒度往往要細(xì)到按鈕級(jí)比如「用戶管理」菜單下有「新增」「編輯」「刪除」「導(dǎo)出」四個(gè)操作這些如果只靠角色硬編碼判斷后期加一個(gè)操作就要改代碼。獨(dú)立成權(quán)限表后權(quán)限碼如user:create存庫(kù)前端按權(quán)限碼控制按鈕顯隱后端按權(quán)限碼做接口鑒權(quán)。-- 核心五張表結(jié)構(gòu)SQL Server 語(yǔ)法MySQL 把 NVARCHAR 換成 VARCHAR 即可 CREATE TABLE Users ( Id INT IDENTITY PRIMARY KEY, UserName NVARCHAR(50) NOT NULL UNIQUE, PasswordHash NVARCHAR(200) NOT NULL, -- 存 PBKDF2 或 BCrypt 哈希絕不存明文 DeptId INT NULL, IsDeleted BIT DEFAULT 0, CreatedAt DATETIME2 DEFAULT SYSDATETIME() ); CREATE TABLE Roles ( Id INT IDENTITY PRIMARY KEY, RoleName NVARCHAR(50) NOT NULL, RoleCode NVARCHAR(50) NOT NULL UNIQUE -- 如 admin、auditor ); CREATE TABLE Permissions ( Id INT IDENTITY PRIMARY KEY, PermCode NVARCHAR(100) NOT NULL UNIQUE, -- 如 user:create PermName NVARCHAR(50) NOT NULL, ParentId INT NULL, -- 支持菜單樹 PermType TINYINT NOT NULL -- 1 菜單 2 按鈕 3 接口 ); CREATE TABLE UserRoles ( UserId INT NOT NULL, RoleId INT NOT NULL, PRIMARY KEY (UserId, RoleId) ); CREATE TABLE RolePermissions ( RoleId INT NOT NULL, PermId INT NOT NULL, PRIMARY KEY (RoleId, PermId) );參數(shù)說(shuō)明PermType用 TINYINT 區(qū)分菜單、按鈕、接口三類前端渲染菜單樹時(shí)只取PermType1按鈕鑒權(quán)取PermType2。IsDeleted做軟刪除后臺(tái)系統(tǒng)里用戶被刪了但歷史日志還要關(guān)聯(lián)硬刪除會(huì)斷鏈。3.2 接口鑒權(quán)怎么落到代碼里權(quán)限碼存庫(kù)之后后端要在每個(gè)接口上校驗(yàn)當(dāng)前用戶是否擁有對(duì)應(yīng)權(quán)限。常見做法是自定義一個(gè)[HasPermission(user:create)]特性配合 ASP.NET Core 的授權(quán)中間件。// 自定義權(quán)限校驗(yàn)特性 [AttributeUsage(AttributeTargets.Method)] public class HasPermissionAttribute : Attribute { public string PermCode { get; } public HasPermissionAttribute(string permCode) PermCode permCode; } // 在中間件或 ActionFilter 里讀取當(dāng)前用戶權(quán)限集合做比對(duì) public class PermissionFilter : IAsyncActionFilter { private readonly ICurrentUser _currentUser; public PermissionFilter(ICurrentUser currentUser) _currentUser currentUser; public async Task OnActionExecutionAsync( ActionExecutingContext context, ActionExecutionDelegate next) { var attr context.ActionDescriptor.EndpointMetadata .OfTypeHasPermissionAttribute().FirstOrDefault(); if (attr ! null !_currentUser.Permissions.Contains(attr.PermCode)) { context.Result new ForbidResult(); // 無(wú)權(quán)限直接 403 return; } await next(); } }邏輯說(shuō)明_currentUser.Permissions是登錄時(shí)從數(shù)據(jù)庫(kù)加載并緩存的權(quán)限碼集合不要每次請(qǐng)求都查庫(kù)。緩存用IMemoryCache或 Redis用戶權(quán)限變更時(shí)主動(dòng)失效。參數(shù)上PermCode要和數(shù)據(jù)庫(kù)Permissions.PermCode嚴(yán)格一致建議用常量類管理避免手寫字符串拼錯(cuò)。3.3 數(shù)據(jù)權(quán)限部門隔離怎么做功能權(quán)限解決「能不能點(diǎn)這個(gè)按鈕」數(shù)據(jù)權(quán)限解決「能看到哪些數(shù)據(jù)」。企業(yè)系統(tǒng)里常見需求是部門經(jīng)理只能看本部門數(shù)據(jù)普通員工只能看自己的。做法是在查詢層統(tǒng)一注入過(guò)濾條件。// 數(shù)據(jù)權(quán)限過(guò)濾根據(jù)當(dāng)前用戶的數(shù)據(jù)范圍拼接 WHERE 條件 public IQueryableOrder ApplyDataScope(IQueryableOrder query) { var user _currentUser; return user.DataScope switch { DataScope.All query, // 全部數(shù)據(jù) DataScope.Dept query.Where(o o.DeptId user.DeptId), // 本部門 DataScope.DeptAndChild query.Where(o _deptIds.Contains(o.DeptId)), DataScope.Self query.Where(o o.CreatorId user.Id), // 僅本人 _ query.Where(o false) // 兜底無(wú)范圍則查不到 }; }參數(shù)說(shuō)明DataScope是枚舉存在角色表上。_deptIds是當(dāng)前部門及其所有子部門的 ID 列表需要遞歸查詢部門樹得到。兜底分支返回false很重要避免權(quán)限配置缺失時(shí)把全量數(shù)據(jù)暴露出去。4. 從接口到頁(yè)面一套可復(fù)用的增刪改查骨架4.1 統(tǒng)一響應(yīng)結(jié)構(gòu)與異常處理后臺(tái)系統(tǒng)的接口返回格式必須統(tǒng)一否則前端每個(gè)頁(yè)面都要寫不同的解析邏輯。我一般用{ code, message, data }三段式。public class ApiResultT { public int Code { get; set; } // 0 成功非 0 業(yè)務(wù)錯(cuò)誤碼 public string Message { get; set; } ; public T? Data { get; set; } public static ApiResultT Ok(T data) new() { Code 0, Data data }; public static ApiResultT Fail(int code, string msg) new() { Code code, Message msg }; } // 全局異常中間件把未捕獲異常轉(zhuǎn)成統(tǒng)一格式避免堆棧泄露到前端 public class ExceptionMiddleware { private readonly RequestDelegate _next; private readonly ILoggerExceptionMiddleware _logger; public ExceptionMiddleware(RequestDelegate next, ILoggerExceptionMiddleware logger) { _next next; _logger logger; } public async Task InvokeAsync(HttpContext context) { try { await _next(context); } catch (BusinessException ex) // 業(yè)務(wù)異常返回可讀提示 { context.Response.StatusCode 200; await context.Response.WriteAsJsonAsync(ApiResultobject.Fail(ex.Code, ex.Message)); } catch (Exception ex) // 系統(tǒng)異常記日志返回通用提示 { _logger.LogError(ex, 未處理異常 {Path}, context.Request.Path); context.Response.StatusCode 500; await context.Response.WriteAsJsonAsync(ApiResultobject.Fail(500, 系統(tǒng)繁忙)); } } }邏輯說(shuō)明業(yè)務(wù)異常如「用戶名已存在」返回 HTTP 200 業(yè)務(wù)錯(cuò)誤碼前端統(tǒng)一彈 message系統(tǒng)異常返回 500堆棧只進(jìn)日志不進(jìn)響應(yīng)。參數(shù)上Code的分配建議按模塊分段比如 1000 段是用戶模塊2000 段是訂單模塊方便排查。4.2 分頁(yè)查詢的通用封裝后臺(tái)系統(tǒng)里 80% 的接口是分頁(yè)列表。封裝一個(gè)通用查詢參數(shù)和返回結(jié)構(gòu)能省掉大量重復(fù)代碼。public class PageQuery { private int _page 1; private int _size 20; public int Page { get _page; set _page value 1 ? 1 : value; } public int Size { get _size; set _size value is 1 or 200 ? 20 : value; } public string? Keyword { get; set; } // 通用模糊搜索詞 } public class PagedResultT { public long Total { get; set; } public ListT Items { get; set; } new(); }參數(shù)說(shuō)明Size上限卡 200防止前端傳size100000把數(shù)據(jù)庫(kù)拖垮這是很常見的翻車點(diǎn)。Page和Size在 setter 里做邊界修正比在每個(gè)接口里判斷更省事。4.3 前端表格頁(yè)的最小閉環(huán)前端不管用 Vue 還是 React一個(gè)列表頁(yè)的最小閉環(huán)是查詢表單、表格、分頁(yè)器、操作按鈕。以 Vue 3 Element Plus 為例核心是請(qǐng)求封裝和權(quán)限指令。// request.js統(tǒng)一請(qǐng)求封裝自動(dòng)帶 token、統(tǒng)一處理錯(cuò)誤碼 import axios from axios const request axios.create({ baseURL: /api, timeout: 15000 }) request.interceptors.request.use(config { const token localStorage.getItem(token) if (token) config.headers.Authorization Bearer ${token} return config }) request.interceptors.response.use(resp { const { code, message, data } resp.data if (code ! 0) { ElMessage.error(message || 請(qǐng)求失敗) return Promise.reject(new Error(message)) } return data // 直接把 data 拋給業(yè)務(wù)層少寫一層 .data }, err { if (err.response?.status 401) router.push(/login) // token 過(guò)期跳登錄 return Promise.reject(err) }) export default request邏輯說(shuō)明請(qǐng)求攔截器統(tǒng)一注入 token響應(yīng)攔截器統(tǒng)一處理業(yè)務(wù)錯(cuò)誤碼和 401 跳轉(zhuǎn)。參數(shù)上timeout設(shè) 15 秒后臺(tái)系統(tǒng)里導(dǎo)出類接口可能超時(shí)這類接口單獨(dú)放寬或走異步任務(wù)。注意別在攔截器里對(duì) 401 做無(wú)限重試會(huì)導(dǎo)致死循環(huán)。5. 避坑與排查后臺(tái)系統(tǒng)交付時(shí)最常翻車的五件事5.1 現(xiàn)象登錄后菜單正常但點(diǎn)按鈕報(bào) 403原因通常是權(quán)限碼不一致。前端按鈕上寫的權(quán)限碼是user:add數(shù)據(jù)庫(kù)里存的是user:create或者后端特性上寫的是User:Create大小寫敏感。這類問(wèn)題在聯(lián)調(diào)階段特別隱蔽因?yàn)椴藛文茱@示說(shuō)明角色權(quán)限關(guān)聯(lián)是對(duì)的只是按鈕級(jí)權(quán)限碼對(duì)不上。解決把權(quán)限碼定義成后端常量類前端通過(guò)接口拉取當(dāng)前用戶的權(quán)限碼列表按鈕顯隱用v-ifperms.includes(user:create)不要手寫字符串。聯(lián)調(diào)時(shí)打開瀏覽器 Network 面板看 403 請(qǐng)求對(duì)應(yīng)的權(quán)限碼再去數(shù)據(jù)庫(kù)Permissions表比對(duì)。5.2 現(xiàn)象列表頁(yè)數(shù)據(jù)量到幾萬(wàn)條后越來(lái)越慢原因一般是分頁(yè)查詢沒(méi)走索引或者用了LIKE %keyword%導(dǎo)致全表掃描。后臺(tái)系統(tǒng)的列表頁(yè)往往帶模糊搜索%開頭的 LIKE 無(wú)法用索引數(shù)據(jù)量一大就崩。解決模糊搜索改成前綴匹配LIKE keyword%或者上全文索引。如果業(yè)務(wù)必須支持中間匹配考慮把搜索字段單獨(dú)抽到一張搜索表用倒排索引方案。另外檢查ORDER BY字段有沒(méi)有索引分頁(yè)查詢的排序字段沒(méi)索引是性能殺手。5.3 現(xiàn)象并發(fā)編輯同一條數(shù)據(jù)后保存的覆蓋了先保存的原因是沒(méi)有做樂(lè)觀鎖。兩個(gè)管理員同時(shí)打開一條用戶記錄A 改了手機(jī)號(hào)保存B 改了郵箱保存B 的提交把 A 的修改覆蓋了。解決在表上加RowVersion字段SQL Server 用rowversion類型MySQL 用version INTEF Core 配置為并發(fā)令牌。保存時(shí)如果版本號(hào)不匹配拋DbUpdateConcurrencyException前端提示「數(shù)據(jù)已被他人修改請(qǐng)刷新后重試」。// EF Core 樂(lè)觀鎖配置 modelBuilder.EntityUser() .Property(u u.RowVersion) .IsRowVersion(); // SQL Server 自動(dòng)維護(hù)每次更新自增5.4 現(xiàn)象導(dǎo)出 Excel 時(shí)內(nèi)存暴漲甚至 OOM原因是把全量數(shù)據(jù)一次性查出來(lái)再寫 Excel。后臺(tái)系統(tǒng)導(dǎo)出幾萬(wàn)條數(shù)據(jù)很常見用ToList()全量加載再遍歷寫內(nèi)存直接頂不住。解決用流式導(dǎo)出。EPPlus 或 NPOI 都支持分批寫入配合 Dapper 的QueryAsync流式讀取每 1000 條寫一批寫完釋放。如果數(shù)據(jù)量超過(guò)十萬(wàn)級(jí)改成異步任務(wù)接口只返回任務(wù) ID后臺(tái)用IHostedService或 Hangfire 跑導(dǎo)出完成后通知用戶下載。5.5 現(xiàn)象部署到服務(wù)器后接口偶發(fā) 500本地復(fù)現(xiàn)不了原因可能是多實(shí)例部署時(shí)IMemoryCache不共享或者數(shù)據(jù)庫(kù)連接池耗盡。后臺(tái)系統(tǒng)如果做了負(fù)載均衡用戶權(quán)限緩存在單機(jī)內(nèi)存里A 實(shí)例改了權(quán)限B 實(shí)例還是舊緩存就會(huì)出現(xiàn)「有時(shí)能訪問(wèn)有時(shí) 403」。解決緩存統(tǒng)一用 Redis別用IMemoryCache存跨請(qǐng)求共享的數(shù)據(jù)。連接池方面檢查連接字符串有沒(méi)有設(shè)Max Pool Size默認(rèn) 100高并發(fā)下容易耗盡適當(dāng)調(diào)大并確保連接用完即釋放。6. 進(jìn)階把后臺(tái)系統(tǒng)做成可復(fù)用的底座做到這里一套能跑的后臺(tái)系統(tǒng)已經(jīng)成型了。但真正拉開差距的是把它沉淀成團(tuán)隊(duì)可復(fù)用的底座。我的習(xí)慣是抽一個(gè)Company.Framework類庫(kù)把統(tǒng)一響應(yīng)、異常中間件、權(quán)限特性、分頁(yè)封裝、審計(jì)日志這些通用能力放進(jìn)去新項(xiàng)目直接引用只寫業(yè)務(wù)模塊。審計(jì)日志這塊值得單獨(dú)說(shuō)。后臺(tái)系統(tǒng)的所有寫操作都應(yīng)該留痕誰(shuí)、什么時(shí)間、改了什么、改前改后是什么。做法是在SaveChanges重寫里攔截 EF Core 的變更跟蹤。// 在 DbContext 里重寫 SaveChanges自動(dòng)記錄審計(jì)日志 public override async Taskint SaveChangesAsync(CancellationToken ct default) { var logs new ListAuditLog(); foreach (var entry in ChangeTracker.Entries() .Where(e e.State is EntityState.Added or EntityState.Modified or EntityState.Deleted)) { logs.Add(new AuditLog { EntityName entry.Entity.GetType().Name, Action entry.State.ToString(), OldValue entry.State EntityState.Modified ? JsonSerializer.Serialize(entry.OriginalValues.ToObject()) : null, NewValue entry.State ! EntityState.Deleted ? JsonSerializer.Serialize(entry.CurrentValues.ToObject()) : null, UserId _currentUser.Id, CreatedAt DateTime.UtcNow }); } AuditLogs.AddRange(logs); return await base.SaveChangesAsync(ct); }參數(shù)說(shuō)明OriginalValues和CurrentValues是 EF Core 變更跟蹤提供的原始值和當(dāng)前值序列化后存庫(kù)。注意別把密碼哈希這類敏感字段記進(jìn)日志可以在序列化前過(guò)濾字段名。審計(jì)日志表增長(zhǎng)很快建議按月分表或定期歸檔。驗(yàn)證這套底座是否合格我的標(biāo)準(zhǔn)是新建一個(gè)業(yè)務(wù)模塊比如「公告管理」從建表到接口到前端頁(yè)面能不能在半天內(nèi)完成。如果還要改框架層代碼說(shuō)明抽象沒(méi)到位。另一個(gè)驗(yàn)證方法是寫集成測(cè)試用WebApplicationFactory起一個(gè)內(nèi)存服務(wù)跑一遍登錄、鑒權(quán)、增刪改查的完整鏈路確保每次改框架層不會(huì)破壞已有功能。最后說(shuō)個(gè)我自己的習(xí)慣每套后臺(tái)系統(tǒng)上線前我一定會(huì)手動(dòng)跑一遍「權(quán)限矩陣」——用管理員、部門經(jīng)理、普通員工三個(gè)賬號(hào)把每個(gè)菜單和按鈕都點(diǎn)一遍確認(rèn)該看到的看到、該攔的攔住。這個(gè)動(dòng)作看起來(lái)笨但比任何自動(dòng)化測(cè)試都容易發(fā)現(xiàn)權(quán)限配置的遺漏。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取