更新日志
[v2.6.2] - 2026.11.05
功能
- 多租户数据隔离与租户级计划任务:
IFreeSql 改为租户感知的 Scoped 代理,仓储、工作单元与后台日志按租户库读写;[Scheduler] 任务新增 TenantScope,默认每个启用租户各执行一次,宿主级任务可显式指定;租户菜单按 Path 只排除宿主级页面(租户管理/错误日志/任务计划),菜单管理与数据字典保留
- CMS 评论开关
EnableComments(默认关闭):关闭时不建评论表、不出评论审核菜单、写入直接报错;已有评论与授权位保留,重新打开即恢复
- 高级搜索的「没填」在框架层处理:空串与
-1 不再被当作筛选条件,可选列不再需要「全部」占位;新增支持可空枚举的下拉组件
问题修复
- 多租户下的聊天与站内信完整隔离:聊天广播、单聊、上下线通知、在线状态,以及站内信/系统通知的实时推送,都按登录票据中的租户编码路由,不再依赖全局连接或全局 Redis 键;不同租户的同名用户 id 不会互相串消息。通知用户组名由
user_{userId} 改为 tenant_{tenantCode}_user_{userId},NotificationHub.GetUserGroup 相应改为 GetUserGroup(string tenantCode, long userId),宿主若自行调用该方法推送消息需同时传入租户编码(通常取 AdminContext.TenantCode)。需要同时升级 EasyAdminBlazor.Chat 2.6.2 与 EasyAdminBlazor.MultiTenant 2.6.2
- 多租户下主库连接空闲 3 分钟后被回收:
FreeSqlCloud 默认会回收空闲实例,主库 ORM 被回收后登录、租户解析等主库访问统一抛 ObjectPool has been disposed。现在主库实例注册为永不回收,租户库仍按默认策略回收(EasyAdminBlazor.MultiTenant 2.6.2)
- SQLite 下保存租户报
database is locked:关联表建表语句落在事务内会锁库,现改为初始化时先建好关联表
- 树形列表筛选后命中的孤儿子行不再整条消失:父行不在本次结果集时子行折算到根层展示,分页与总数不变
文档
- 开发规范与企业站生成流程合并为单一项目 skill(
.github/skills/easyadminblazor-dev),含 pitfalls 自查表与企业站模板;
[v2.6.1] - 2026.10.26
问题修复
- 修复在线人数在连接生命周期回调与页面绑定并发时的虚增或漏计
- 修复列表按钮参数只在首次渲染生效,父组件后续动态修改不生效
- 修复二级导航中的大字段标记在中间实体无标记时漏算
- 拆分 NuGet 包许可证:
LICENSE 为免费使用许可,LICENSE-SOURCE 为源码商业授权协议
verify-packages.ps1 支持四段版本,并校验包内所有 lib/、ref/ 程序集
文档
- 修正
KeepOriginalFile、多租户数据库模式、后台安全码示例等说明
[v2.6.0] - 2026.10.25
破坏性变更
- 移除私有文件受控下载功能:
/api/files/{id} 接口与 FileService.OpenPrivateFileAsync 方法一并移除,文件一律走静态地址。升级前请检查自己的代码是否引用了这些成员(框架内置的所有扩展包均无引用,已逐一核对)。移除的原因是上传的文件本就放在 wwwroot 下、可被静态访问,这个开关从未真正起到保护作用。文件记录的访问地址仍可通过 SysFile.AccessUrl 获取。SysFile.IsPublic 字段仍保留在实体上,但不再参与任何业务判断
功能
- 列表轻量查询:远端数据库(云库、跨机房)上,列表默认
SELECT * 会把实体以及 Include 进来的导航实体的大字段(longtext / blob)一起拉回,单页几十行就可能传输几 MB、耗时十几秒,而列表真正用得上的往往只有几十个普通字段。页面在 OnBeforeQuery 里调用 e.Select.LightQuery() 即可让列表只查真正用得上的字段:主表只查非大字段列,导航对象按外键批量补齐(补齐时同样只取非大字段),Where / OrderBy / Include 等原有写法一行不用改;需要某个大字段回到列表时用 e.Select.IncludeLargeColumns(x => x.Remark) 点名。默认关闭,其它项目的行为与 SQL 完全不变
- 大字段标记:只需要知道大字段"有没有值 / 有多长"而不需要正文时,在实体上加一个标记属性即可(
[Column(IsIgnore = true)] public bool? IsRemark { get; set; },或 {列名}Length 取长度,或用 [LargeColumnFlag("列名")] 显式指定源列)。轻量查询下由 SQL 计算(Review IS NOT NULL AND Review <> ''),普通查询下由内存计算,两种模式的结果完全一致;导航实体上的标记同样生效
- 编辑弹窗按主键回查完整行:轻量查询下列表行不再带大字段,打开编辑弹窗前会按主键回查完整行;表单里的大字段仍是完整内容,保存不会把未加载的字段写成 null
- 后台页头新增「获取源码」入口:
ShowSourceLink(默认 true)控制是否显示;已购买源码授权的项目可在 AddEasyAdminBlazor 里设为 false
- 页脚与登录页的版权文案不再带 All rights reserved.
- NuGet 包页面补齐官网入口与授权协议:新增项目主页、图标、标签与发布说明,并随包分发免费使用许可(
LICENSE)与源码商业授权协议(LICENSE-SOURCE)
- 新增《安全配置》文档:集中说明上传大小、重定向次数、登录锁定、CSRF、Host 白名单、限流、外部调用超时等 11 项安全配置
问题修复
- 在线人数不再只增不减:改按浏览器连接统计,正常断开后很快减少(异常断网取决于 SignalR 的断开检测)
- 列表查询异常时 loading 遮罩不再卡死
- 列表的按钮权限与回收站模式不再被父组件参数覆盖
- 「为空 / 不为空」过滤器不再抛异常
- 大字段标记的类型、取值路径与命名约定修正
- 图片转 WebP 不再覆盖已有文件
- 保留原图模式下不再生成无人引用的 WebP:
KeepOriginalFile=true 时非 WebP 原图直接保留,不转换、不缩放,也不会留下孤儿 .webp 文件(已是 WebP 的图片超宽时仍会缩放重编码)
- 图片解码增加像素上限:新增配置
FileSettings:MaxImagePixels
- Windows 保留设备名不再让「新建分组」崩溃
- 畸形 User-Agent 不再让登录崩溃
- 本地跳转不再能被 TAB 绕过
- 防伪 Cookie 补上
Secure 属性
- 审批撤回不再被上一轮的记录永久禁用
- 审批流程改级次不再让在途单据卡在「审批中」:单据以提交时的级数推进(新增
SysApprovalRecord.TotalLevels)
- 计划任务的自定义 Cron 按调度器时区解析:不再整体偏移 8 小时
- 非法的
[Scheduler] Cron 不再每 5 秒执行一次:校验不通过就不进入调度
- 暂停的计划任务重启后不再自动复活
ISchedulerService.FindTask 不再抛异常
- Excel 导入不再绕过「编辑」权限改写既有数据:会更新既有记录的行要求
edit 权限
OnBeforeImportAsync / OnBeforeSaveAsync 里替换的对象与集合不再被忽略
- 开启导入按钮不再顶掉页面自己的工具栏
- 导出文件不再比表格少列
- 消息中心不再强制依赖 Redis 扩展:此前后台菜单与右上角通知图标都要求
IRedisService 已注册(EnableMessage 打开但没装 Redis 扩展时,消息中心菜单不显示、直接访问 Admin/Message 会被跳回首页)。消息中心本体只依赖数据库与 SignalR(NotificationHub 已是替代原 Redis Pub/Sub 的方案),Redis 仅用于聊天消息缓存落库,因此现在只看 EnableMessage 开关;装了 Redis 的项目行为不变
- 轻量查询下 ORDER BY 列名歧义:投影裁列后排序列不在 SELECT 列表里,排序用的裸列名(如
ORDER BY createdtime desc)失去了唯一指向,JOIN 了同名列的表时会报 Column 'createdtime' in order clause is ambiguous。轻量模式下的排序现在统一转成带表别名的列排序(表别名 + 列名),排序语义与普通查询保持一致(页面自带 OrderBy → SortList → SortName)
- 微信扩展的限流配置不再形同虚设:
Security:RateLimitPermitLimit 与 Security:RateLimitWindow 以前没有任何代码读取(阈值写死在代码里,改配置不生效)。现在这两个配置真正参与计算,且只收紧不放宽(与各端点自身阈值取小),默认行为与之前完全一致
[v2.5.1] - 2026.10.23
问题修复
[v2.5.0] - 2026.10.23
问题修复
- 暗黑模式下顶栏回归深色:
ant.css 不再无条件用主色刷顶栏与 Logo 区,暗色主题下改用深色顶栏变量,主色只作用于浅色顶栏
- 顶栏主题色按钮不再是一块蓝色实心块:下拉按钮改用透明底 + 顶栏前景色,悬停/展开时以白色半透明高亮,与明暗模式按钮风格一致
- 后台首页与登录跳转统一为
/Admin/:补齐尾斜杠,避免不同入口下路由解析不一致
AdminSelectEntity 首次渲染不再显示空白:改为在 SetParametersAsync 里先装载 Items 再进基类初始化,消除「缓存未命中时先渲染一帧空列表、导致选中项文本永远为空」的时序缺陷
- 角色权限树支持配「只读角色」:菜单权限树不再使用组件库默认的父子联动,改为框架自有规则 —— 取消勾选某个菜单下的按钮时,菜单页面与分组保持勾选(可配出「只看不能按」的查询员 / 报表岗);同时修复打开只读角色编辑页时,已保存的菜单权限被重算成未选中、一保存就被清空的问题
功能
- 新增
carbon.css 主题样式:Carbon 风格配色(深色顶栏、低饱和背景),由宿主项目按需引用,Demo 默认不启用
- 新增审批失败文案扩展点
IApprovalFailureMessageProvider(Core 契约层):审批处理失败时先问业务模块注册的文案钩子,命中则透出可读文案(仍附带 TraceId 便于排障),未命中回退通用文案;不注册钩子时行为与改造前完全一致
- 新增审批业务后置钩子
IApprovalPostAction(Core 契约层):审批"通过"的瞬间在同一事务内执行业务写入(如进销存过账),业务模块只需实现钩子即可接入;未注册钩子时行为不变。同时 AdminTable 保存后自动提交审批,且审批中的单据禁止修改与删除
[v2.5.0-beta.1] - 2026.10.21
问题修复
- 上传文件的
Md5 不再恒为空:改为落盘后按最终文件内容计算(图片压缩可能转 WebP,取的是落盘结果),写入大写 32 位十六进制,与后台远程抓图写入的格式一致
FileService.IncludeExtension 不再被实例覆写:该属性需要被所有实例共享(AdminFilePicker、File 页面静态读取),改为注册阶段由 AddFileService 从配置初始化一次,Scoped 实例不再重复写入静态状态
AdminTable 的忽略查询列支持参数变化:IgnoreSearchColumns 变更后重新提取,不再沿用首次调用的结果
- SQLite 下 Excel 导入不再因
UpdateColumns 失败
多语言
- 扩展可自带语言包:语言文件随扩展程序集分发(
Locales/zh.json、Locales/en.json),CMS 已接入,框架统一收敛扩展语言包注册
- 后台断线重连提示支持中英文(
EasyAdminReconnector)
- 升级扩展(
EasyAdminBlazor.Upgrade)支持中英文
功能与兼容
- 断线重连交回 BootstrapBlazor:
adminblazor.js 只保留升级逻辑,未安装升级扩展时不再误报「与服务器的连接已中断」
- 升级遮罩固定提示文案:升级中标题固定为「应用升级中,请稍候……」,不再轮换显示「正在停止应用…」等阶段文字;保留升级程序无响应的排查提示;修复回滚误判,统一升级宿主与
setsid 查找
- easyadmin-frontend / easyadmin-conventions 技能同步 CMS 模块:corporate 模板升级为 CMS 内容驱动(
[CmsPage] 页面定义、vc:textblock 文案块、CmsData 示例种子、Slug 路由与旧链接兼容),conventions 补充扩展开发约定与前台内容选型;doc/AI助手配置 中英文同步
- 文档补齐 CMS 相关内容:
如何自建扩展 扩展点增至 7 个(新增操作日志参数脱敏 IOperationLogParameterRedactor)、参考实现表补 CMS;README 索引、项目介绍、开始一个新模块(含"内容类栏目不用建实体"提示)、常见问题(升级登录态保留前提)中英文同步,应用升级 中文版补排查表
如何自建扩展 菜单初始化示例改用框架自带 MenuProvisioning:EnsureMenuAsync / EnsureButtonsAsync 幂等建菜单与按钮权限,替换原来手写的"先查后插"代码(与计划任务、审批、打印、多租户、代码生成等官方扩展写法一致)
- 邮件服务商拆分:邮件配置按分组读取(兼容旧版布局),安全配置去掉静态状态
- Redis 写入改用 FreeRedis 原生异步接口
- 微信接口限流改用 .NET 内置滑动窗口限流器
- 打印扩展复用主项目的 TopN SQL 生成
重构与代码质量
- 大文件按职责拆分为 partial 文件:
AdminTable、ApprovalService、AdminContext、FileService、WeChat、FreeSqlExtensions 等
AdminExtensions 的 12 个 partial 合并为 3 个(注册入口 / 基础设施 / Web 业务),并补充 19 步注册流程的逐行注释
- 收敛重复实现:登录票据解析与校验、列名解析改用强类型
ColumnAttribute、AdminTable 保存与写权限校验统一入口
- 删除死代码与冗余局部变量,扩展内无用的转换与反射工具一并清理
[v2.4.2] - 2026.10.18
- 增强数据库兼容与性能:自定义字段筛选适配 SQLite;CMS 列表默认不读取正文,可选加载正文,并按排序值和 Id 保持分页稳定
- 扩展提供内容、分类、页面元素、SEO 和评论管理:支持页面内 Live Edit、评论提交与审核、按 ID 或 Slug 读取详情,以及前后台统一的提交接口
- 新增 CMS 扩展
EasyAdminBlazor.Cms:基于 [CmsPage] / [CmsDataType] 声明内容类型和页面,自动完成表结构同步、后台菜单与字段配置,文档
- 升级 BootstrapBlazor 至 11.0.1
- 修复文件选择弹窗上传/删除按钮消失:
AdminFilePicker 在认证状态就绪前判定权限,远程库较慢时 admin.User 为空,按钮被按「无权限」隐藏
- 修复页面级升级轮询在页脚渲染前执行导致不生效
[v2.4.1] - 2026.10.15
- 更新有漏洞的 SignalR 包
- UseEasyAdminBlazor 支持自定义 ServerComponentsEndpointOptions
[v2.4.0] - 2026.10.10
升级注意事项(从 2.3.x / 2.4.0-preview 升级)
Program.cs 必须改为 app.UseEasyAdminBlazor<App>();:TApp 传宿主自己的 App 组件(Components/App.razor)。框架会自动把已注册的扩展程序集加入 Razor 组件路由,宿主不要再写 app.MapRazorComponents<App>().AddAdditionalAssemblies(...),否则会重复映射
Components/Routes.razor 的 AdditionalAssemblies 改为从配置读取:
@using System.Reflection
<Router AppAssembly="@typeof(Program).Assembly" AdditionalAssemblies="@AdditionalAssemblies">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
</Router>
@code {
private IEnumerable<Assembly> AdditionalAssemblies =>
AdminOptions.Value.Assemblies ?? [];
}
可选功能扩展化(新增打印、代码生成扩展)
- 新增
EasyAdminBlazor.Print 扩展:打印模板、报表设计器与打印实现(PrintTemplate / ReportDesignerEditTemplate / IPrintService / PrintServiceImpl / report-designer*.js)从框架迁入该扩展;框架只保留兼容门面 PrintService,不引用扩展就没有打印功能
- 新增
EasyAdminBlazor.CodeGenerator 扩展:代码生成页面 CrudGenerator 从框架迁入该扩展
- 页面随各自扩展发布:
TaskScheduler、Tenant、ApprovalTodo 等页面分别迁到 EasyAdminBlazor.Scheduler / MultiTenant / Approval 扩展,ErrorLogCleanupJob 一并迁到 Scheduler 扩展
- 统一的扩展初始化机制:新增
IExtensionInitializer(Core)与 ExtensionInitializerHostedService(框架),扩展通过 AddEasyAdminBlazorAssembly() 注册自身程序集与初始化器,菜单、种子数据在启动时自动初始化
UseEasyAdminBlazor<TApp>() 改为泛型:自动把已注册的扩展程序集加入 MapRazorComponents().AddAdditionalAssemblies(...),扩展页面不需要宿主手工注册
问题修复
- 未引用升级扩展时不再常驻「连接已中断」提示:
adminblazor.js 在没有升级版本标记(未安装 EasyAdminBlazor.Upgrade)时不再接管连接与重连提示,交回 Blazor 自己处理;修复登录页、后台页面一直显示「与服务器的连接已中断,正在重连…(应用重启中请稍候,恢复后会自动继续)」的问题
- 无权限的页面不再跳转到登录页
其它
- 授权协议更新:
LICENSE 更换为 EasyAdminBlazor 商业软件授权协议
- 框架、Core、全部扩展、文档统一到 2.4.0
依赖升级与兼容性适配
- 彻底移除 SixLabors,图片处理与验证码统一改用 SkiaSharp:框架不再引用
SixLabors.ImageSharp,FileService 的图片格式校验(IsImageByImageSharp → IsImageBySkiaSharp)、宽高读取、超宽等比缩放(最大宽度 1600)与 WebP 转换全部改为 SkiaSharp 实现,源码客户 restore/build 不再触发 Six Labors License 提示;新增 SkiaSharp 与 SkiaSharp.NativeAssets.Linux.NoDependencies(Linux 宿主免装 fontconfig)
- 升级 BootstrapBlazor 10.9.2 → 10.10.2(框架与
EasyAdminBlazor.Upgrade 扩展同步;BootstrapBlazor.TableExport 10.0.2 → 10.0.3)
- 表单校验改为异步:
EditContext.Validate() 已过时,框架内统一改用 await EditContext.ValidateAsync()(EditContextCapture.ValidateAsync()、个人资料保存、修改密码、AdminTable 新增/编辑保存前校验),校验行为与提示保持不变
- 各扩展依赖同步升级:
SkiaSharp 3.119.4、Microsoft.AspNetCore.SignalR.Client 10.0.12、Microsoft.AspNetCore.SignalR 1.2.13、MailKit 4.18.1、FreeScheduler 2.1.5、ZiggyCreatures.FusionCache 2.9.0、AlibabaCloud.SDK.Dysmsapi20180501 1.0.11、System.Security.Cryptography.Pkcs 10.0.12
- 宿主与测试工程依赖同步升级:
Microsoft.Extensions.Hosting.WindowsServices / Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 10.0.12;Microsoft.NET.Test.Sdk 18.10.1、xunit.runner.visualstudio 4.0.0、FluentAssertions 8.11.0、Moq 4.21.0、coverlet.collector 10.1.0
应用在线升级(作为独立扩展 EasyAdminBlazor.Upgrade 提供)
- 应用版本与框架版本彻底分离:应用版本来自宿主 csproj 的
<Version>(发布版本 = 应用版本),框架版本用独立的 EasyAdminBlazorVersion 读取,宿主用 -p:Version 指定应用版本不会再影响框架版本;页脚显示 Powered by EasyAdminBlazor v2.4.0-preview.4 · 应用 v1.1 · 检查更新
- 后台「检查更新」入口:不新增菜单/页面,复用现有弹窗、打开即检查,显示当前版本、最新版本、更新说明与升级包大小,只有管理员能执行升级
- 逐版本增量升级:升级包按
previousVersion 串成链(1.0 → 1.1 → 1.2),客户落后多个版本时自动依次升完,不需要手工跳版本
- 发布即出包:Release 配置下发布一次,增量包自动落在发布目录
updates/v<版本>/(update.zip + release.json + files.json + 更新 index.json),上一版本自动识别;更新说明写项目根目录的 release-notes.txt
- 两种发布来源:本地发布目录(内网/私有化,人工拷包)与 HTTPS 发布索引(客户自己点升级)
- 客户数据零风险:
wwwroot/uploads、logs、DataProtection 密钥、updates、appsettings*.json、数据库文件永不写入/删除;删除条目必须哈希一致;备份只针对即将被覆盖的文件
- 安全与并发:包 SHA256、包内文件哈希、基线哈希三重校验;ZIP 路径穿越/绝对路径/符号链接一律拒绝;同一应用同时只允许一个升级任务
- 失败只回滚当前一步,并保证把应用重新拉起来(含多层兜底),已成功的步骤保留
- 升级过程可视化:点「立即升级」后显示全屏遮罩(应用停掉、连接断开也不影响),滚动升级时显示「第 x/y 步,正在更新到 vN」,健康检查确认目标版本后显示「升级完成」并倒计时 3 秒自动刷新,用户不需要重新登录
- 在线用户统计:新增
IOnlineUserCount(Count 在线人数、UserIds 在线用户 Id 列表,按用户去重),升级确认框会提示当前在线人数
- 部署适配:
RestartMode 支持 Direct(自托管/宝塔/systemd)、WindowsService、Systemd、External;IIS 进程内托管时自动禁用升级入口
- 作为独立扩展提供:引用
EasyAdminBlazor.Upgrade 才有升级能力;不引用则页脚、/health、发布钩子都不存在,老项目行为完全不变。支持 NuGet 包引用(发布钩子在包内自动生效,纯 NuGet 也能自动出包)与源码引用
- 详细说明见 应用升级
[v2.3.2] - 2026.10.01
安全加固
- 登录票据升级为 v2:票据绑定签发租户并带签发时间,服务端强制校验
TicketLifetime;旧 v1 票据一律按未登录处理(升级后需要重新登录一次)。同步修复 NotificationHub / ChatHub 只解析用户 Id、不校验租户与有效期的问题
- Host 白名单校验:新增
Security:AllowedHosts,多租户按 Host 解析租户前先做白名单校验,防止 Host 头伪造切租户;留空表示不限制(保持历史行为),支持 *.example.com
- 登录锁定接入配置:
Security:LoginFailureLimit / LoginLockout 真正生效(默认 5 次 / 10 分钟),改为"先计数再判定"并把账号维度纳入锁键,并发登录无法叠加额度;锁定在服务端强制生效,不再只靠登录页
- 强制改密服务端拦截:
ForcePasswordChange 在新增/编辑/删除/导入等服务端写入入口统一拦截,默认口令账号改密前不能再写数据
- DatabaseLogger 用户归属修复:日志提供程序改为通过当前请求/电路身份 + 请求作用域读取用户与租户,移除 captive dependency,
SysLog 重新带上 UserId / TenantCode
- AesKey 真正生效:
AesKey 现在派生 Data Protection 的 ApplicationName,参与 Cookie/票据的密钥隔离;更换 AesKey 会让旧登录态失效(与文档一致)
工程改进
- 通用业务写入加事务边界:
AdminTable 的新增/编辑/删除/导入统一走 UnitOfWorkManager + Binding(与 ApprovalService 相同写法),失败整体回滚
- CI 与构建门禁:新增 GitHub Actions(build + test)、
Directory.Build.props 与 .editorconfig 收敛公共配置并开启警告即错误(历史 nullable 警告已全部清零,无任何豁免)
- 可维护性:
AdminTable.razor 拆出导出功能 partial;EasyAdminBlazor.Test 重命名为 EasyAdminBlazor.Demo
- 菜单管理默认收起按钮节点:
/Admin/Menu 默认不显示按钮类型节点,需要查看时勾选工具栏“显示按钮”
- 操作日志记录变更明细(长文本 DiffPlex 高亮):修改类操作在写入前取旧值快照,字段变更结构化保存;短字段显示“旧 → 新”,长文本用 DiffPlex 做词/字符级行内高亮且不截断(超大字文本退化为整段对比,内容仍完整);集合列(
[JsonMap] 等)按内容比较并展示 JSON;没有实际变更的保存不产生日志;审计字段跳过,密码等 [JsonIgnore] 只记“(已修改)”
- 失败操作记录失败原因:方法内部 catch 后返回失败(保存异常、权限/数据权限校验不通过、审批中禁止修改、强制改密拦截等)同样会写入失败原因;无法拿到具体原因时给出兜底文案,不再出现空原因
- 编辑弹窗可查看修改历史:
AdminTable 编辑弹窗左下角新增“修改历史”,按 EntityType + EntityKey 查询该记录的操作日志并以 DiffPlex 渲染变更明细;入口与编辑同一口径(按钮权限 + 数据权限),且仅对已落库记录显示;SysOperationLog 新增 EntityType/EntityKey 两列与 idx_operationlog_entity 索引(旧数据这两列为空,不会出现在记录历史里)
- “保存不关闭”保持弹窗并兼容级联保存:保存成功后弹窗不再关窗重开,就地重启草稿自动保存,新增记录后续保存自动按“修改”处理;保存后重新附加当前模型(含子集合),避免级联保存时把已存在的子记录当新增重复插入
- 回收站(软删除恢复 / 彻底删除):实现了软删除的实体,工具栏“回收站”开关位于删除按钮之后;进入后只显示已删除数据(临时禁用软删除全局过滤),可逐条或勾选后批量“还原”/“彻底删除”(彻底删除需二次确认);权限沿用删除权限,非软删除实体不显示该入口
- 修复任务计划“下次运行”列表头:该列此前误绑定到
Topic,导致表头显示“标题”、内容却是日期;现绑定到 NextRunTime
[v2.3.1] - 2026.09.19
问题修复
- 文件上传不再被误挡成 401:移除
FileUploadController 上叠加的 [Authorize]。框架的登录态是自定义加密 Cookie,并非 ASP.NET Core 标准认证方案;叠加该特性会让请求在进入控制器之前按"默认认证方案"校验,宿主项目若把自己面向站点用户的 Cookie 设为默认方案,后台管理员上传时会被直接挡成 401,而控制器内的 IsLogin() 判断根本没有机会执行。现统一由 IsLogin() 判定并返回 401。
- 编辑器保存远程图片 CSRF 失败修复:编辑器改为写请求前先取 Antiforgery 令牌并带上请求头(头名由服务端下发,不写死),令牌失效时自动刷新重试一次;取令牌失败会在控制台输出原因,不再静默失败。
[v2.3.0] - 2026.09.17
安全加固
- 通知 Hub 越权修复:
NotificationHub 改为必须认证,用户组只按服务端解析出的当前用户加入/移除;删除可传入任意 userId 的 JoinGroup / LeaveGroup,前端改为随连接携带签名票据
- HtmlEditor 上传 CSRF 防护:上传与保存远程图片接口增加认证与 Antiforgery 校验,校验失败返回 400 而非 500;编辑器通过
X-CSRF-TOKEN 请求头携带令牌
- 远程图片下载 SSRF 加固:禁止自动重定向,逐跳重新做地址校验(最多 3 次、禁止 HTTPS 降级);通过连接回调锁定已校验 IP,杜绝 DNS Rebinding;响应流式落盘,避免内存无限增长
- Excel 导入数据权限:导入、批量更新、批量删除统一走数据权限校验,不能再靠伪造主键越权操作他人数据
- 私有文件下载:新增受控下载接口
/api/files/{id},校验登录、租户、文件记录与授权;公开文件仍走原有静态地址,行为不变
- 路径安全:新增统一安全路径服务,代码生成器、上传、下载、模板等路径全部做根目录包含性校验,路由路径增加白名单
- 登录票据认证:新增认证处理器,使
[Authorize] 能识别框架现有的加密 Cookie 登录态
多租户隔离
- 移除二级容器:多租户扩展不再使用
BuildServiceProvider(),FreeSqlCloud 改由服务提供者工厂注册
- 建表并发保护:同一租户的初始化串行化,避免并发请求重复建库建表
- 租户编码白名单:创建、切换与获取租户数据库前统一校验编码,避免其进入数据库名、文件路径与缓存键
- 缓存与 Redis 隔离:系统参数、权限、下拉/树/字典缓存及聊天 Redis 键全部带上租户前缀,租户之间不再共用业务缓存与锁
审批一致性
- 事务化:提交、同意、驳回、撤回、转交全部纳入数据库事务,任一步失败整体回滚,不再出现半成功数据
- 并发保护:所有状态变更改为条件更新,并发审批/转交/撤回只会成功一次,不会重复推进节点或产生重复审批记录
- 通知时机:站内信与实时推送统一移到事务提交之后,提交失败绝不通知成功
- 服务端权威:审批人、当前节点、下一节点、审批级次完全由服务端按流程配置决定,客户端无法指定或跳节点
- 转交资格校验:转交目标必须属于当前租户且处于启用状态,禁止转交给发起人
- 审批意见防 XSS:意见按纯文本存储并做 HTML 实体编码,同时限制长度
- 流程配置校验:配置加载后立即校验级次连续性、审批人来源合法性与节点数量上限,非法配置直接拒绝执行
- 异常信息收敛:审批失败只返回通用提示与 TraceId,详细异常仅写日志
- 审计字段:审批记录新增操作人、变更前后状态与流程实例标识,转交与撤回可完整追溯
问题修复
- 右上角通知重复显示:修复数据库未读列表与 SignalR 实时推送同时到达时同一条消息被插入两次的问题
- PBKDF2 参数升级:密码哈希升级为带版本与迭代次数的新格式,旧密码仍可正常登录并在登录成功后自动重新哈希
- 上传状态码语义化:未登录 401、无权限 403、参数错误 400、文件过大 413、格式不支持 415,不再所有错误都返回 500
- 上传大小双层限制:HTTP 解析层与业务层都做 10MB 限制
- 微信匿名接口防刷:登录、解密与生成小程序码增加参数校验、限流与超时,错误不再回传外部接口细节
- 数据库日志限流:写库失败时使用有界缓存与指数退避,恢复后自动补写,并补充 TraceId、请求路径、用户与租户字段
- 同步阻塞消除:移除
GetAwaiter().GetResult() 之类的同步阻塞异步写法
- 计划任务时区可配置:时区不再硬编码,默认保持原有中国时区行为
- 雪花 ID 启动校验:WorkId 保持 6 bit,超出范围启动即报错,提示多实例配置不同 WorkerId
新增功能
- 统一安全配置:新增
Security 配置节,集中管理上传大小、重定向次数、登录锁定、CSRF 与限流参数,并附示例
- 全局异常处理:接口异常统一转成友好提示 + TraceId,详细异常只写日志
[v2.2.18] - 2026.09.08
新增功能
- 保存后页码保留:编辑已有数据保存后停留在当前页码,不再跳回第一页;仅新增时才回到第一页展示最新记录(“保存并关闭”与“保存不关闭”一致)
- 更换数据库指南:新增《更换数据库类型》文档,介绍如何从 SQLite 切换到 MySQL / SQL Server / PostgreSQL 等 FreeSql 支持的数据库
- Serilog 文件日志配置指南:新增《Serilog 日志配置》文档,提供与框架数据库日志并存的接入方式(
writeToProviders: true)
问题修复
- 文件上传提示修复:上传过程任何异常(磁盘/权限/图片处理/数据库等)统一转为“上传失败”提示;上传弹窗增加 60 秒超时自动关闭兜底,避免“上传中”提示永久不关闭
- 在线聊天“操作已取消”错误修复:修复 SignalR 连接与在线状态维护在取消/释放时抛出的 “The operation was canceled” 错误,避免在线用户状态异常
- 强认证下聊天/通知自连接失败修复:通知与聊天原先用公共域名做服务端自连,强认证(HttpOnly Cookie)、反向代理或局域网 IP 访问时服务器连不回自己导致 SignalR 连接全部失败、聊天永远离线、页面反复刷新;现改为使用 Kestrel 实际监听地址,连接失败只降级相关功能,不影响页面与电路
- 菜单 PathLower 空引用防护:后台菜单过滤对
PathLower 判空,避免空值导致布局崩溃
- 代码生成行布局修复:生成页面编辑字段数量较少时正确包裹
row form-inline 容器
- MailKit 版本升级:邮件扩展显式引用 MailKit 4.17.0,避免与 NETCore.MailKit 传递依赖冲突
[v2.2.17] - 2026.08.30
新增功能
- 编辑弹窗保存按钮 loading:新增/编辑窗口点击“保存”或“保存并关闭”任意一个后,两个按钮同时显示加载状态并禁用,保存出错(含异常)自动恢复可点击,同时防止重复提交
- 表格查询期间显示 loading:AdminTable 数据查询中空行不再闪现“无数据”,查询完成前显示加载指示,结束后才根据结果展示数据或“无数据”
- 导出性能大幅优化:AdminTable 导出只查询表格可见列(动态 DTO 投影),不再 SELECT * 拉取大文本/导航数据;导出时跳过 Include/IncludeMany 导航集合加载(查询事件新增 IsExport 标记);Excel 直接以 MiniExcel 写入,Lookup 列只解析一次;远端数据库场景下数千行导出从分钟级降到秒级,导出文件只包含可见列
- 点击导出立即提示:导出时表格工具栏显示“正在导出”徽标(服务端状态驱动、非阻塞),一点导出即出现,完成或出错自动消失
- Data Protection 密钥持久化:新增 DataProtectionKeyPath / DataProtectionApplicationName 选项,可将认证 Cookie 加密密钥持久化到固定目录并固定应用名,IIS 程序池重启后不再强制重新登录
问题修复
- 解决方案构建修复:EasyAdminBlazor.AliyunSms 扩展目标框架由 net9.0 修正为 net10.0,并统一所有项目版本号
- 消息中心连接泄漏修复:Widget 组件重写 DisposeAsync(bool) 释放 SignalR 连接,修复组件销毁时连接未释放的问题
- AdminTable 权限包装逻辑修复:内部默认保存/删除委托不再在二次渲染时被重复包装(原方法组比较恒为 false 导致重复权限校验)
- 启用/禁用开关可靠性修复:用户、菜单、组织页面的启用/禁用切换改为等待数据库写入,失败时回滚开关状态并提示错误
- Redis 消息落库健壮性:反序列化失败的条目不再传入数据库写入
- 微信支付证书加载现代化:改用 X509CertificateLoader 替代已过时的 X509Certificate2 构造函数;平台证书缺失时给出明确错误日志
- 用户角色搜索“无法匹配 Roles”修复:忽略搜索列改为在组件首次渲染前提取,避免首次查询竞态导致导航集合(Roles)过滤直接传入 FreeSql 报错;动态过滤剪枝后不再残留空壳节点
- 演示项目移除未使用的 Session 中间件:应用本身不使用 ASP.NET Session,移除后不再出现“Error unprotecting the session cookie”警告
- 测试代码现代化:日志队列测试改用异步等待,消除阻塞调用
[v2.2.16] - 2026.08.22
新增功能
- 企业站前台 Tailwind 模板:新增 easyadmin-frontend skill(corporate 模板,Tailwind CSS 简洁大气风格);前台新增首页/服务/产品/新闻/联系我们,新闻含分类筛选与评论(验证码+审核),导航含后台入口;新增 Service/Product/Feedback 实体与后台 CRUD 页面;初始化服务/产品示例数据与演示菜单(服务/产品/留言反馈),博客菜单更名 新闻管理/新闻分类(中英文);移除旧 Themes 主题功能
- EasyAdminBlazor.Mail 新增腾讯云邮件推送(SES):直接调用腾讯云 API(TC3-HMAC-SHA256 签名),不引入 SDK
- 邮件服务商切换:新增
Mail:Provider 配置(Smtp / SendCloud / TencentCloud),默认 Auto 自动选择(SendCloud → 腾讯云 → SMTP),调用方无需改代码即可切换
- 模板邮件:腾讯云模式下
SendTemplateEmailAsync 传模板ID(数字),模板参数自动转为 TemplateData JSON
- 后台配置:系统配置页新增 SendCloud / 腾讯云参数分组,各组均支持发送测试邮件;显式指定
Mail:Provider 时只展示对应服务商的配置项,Auto 时才展示全部
- 按调用指定服务商:
SendEmailAsync 新增可选的 provider 字符串参数("Smtp" / "SendCloud" / "TencentCloud"),调用时可临时指定;服务商由 Mail 扩展解析,Core 不依赖具体服务商,后续新增服务商无需发布 Core
- 配置页数据驱动:后台"邮件测试"由配置贡献者声明驱动(
IsEmailProvider / EmailRequiredKeys),新增邮件服务商只需在 Mail 扩展中加贡献者类,无需再改 /Admin/Config
- 数据权限接口自动开启:AdminTable/AdminMultiSelect/AdminSelectTable 在实体实现 IDataPermission+IEntityCreated 时自动启用数据权限,无需页面显式配置
- 前台底部官网链接:前台公共布局底部增加官网入口
- AI 助手配置文档:新增
doc/AI助手配置.md(含英文版),介绍 easyadmin-conventions / easyadmin-frontend 技能与企业站模板在 ChatGPT / Cursor / Claude 中的使用方式
问题修复
- 腾讯云邮件 API 业务错误误判修复:腾讯云 API 3.0 对业务错误也返回 HTTP 200,错误在响应体
Response.Error 中,现会正确识别并返回失败
- 邮件发送失败原因写入错误日志:SendCloud / 腾讯云发送失败原因以 Error 级别写入错误日志(错误日志只记录 Error 及以上级别)
- 官网域名拼写修正:easyadmim 修正为 easyadmin(后台布局、首页、README、文档)
- 租户主键冲突修复:删除 SysTenant.Id 遗留 AOP 分支,long 主键不再被 ToLower() 且恢复雪花 ID 生成,修复新增第二个租户时主键冲突
- 企业站菜单种子幂等修正:迁移旧格式 /Admin/Service 路径、Path 统一为 Admin/*,避免重复插入菜单;首页文档解析正则与 csproj 清理
- AuthPath 状态残留修复:带按钮参数时同步更新 AuthPathSuccess,页面主体不再残留旧状态
- Redis 订阅异常保护:RedisService.Subscribe 反序列化失败不再中断订阅
- 空引用与警告清理:HexToBytes 返回类型修正为 byte[]?;Chat.razor / FileUploadController / Generator.Model 消除空引用与未赋值警告;移除 MainLayout 中的 Console.WriteLine 调试残留
- 更新日志不显示修复:后台首页可正常展示更新日志
重构与其他
- 精简解决方案:删除 EasyAdminBlazor.Api.Host 与 EasyAdminBlazor.Application 项目;博客实体 Article/Classify/Comment 移入 EasyAdminBlazor.Test/Entities/Blog(命名空间不变);解决方案与 csproj 引用同步更新;skill 与 doc 补充分层架构说明(共享层 + 多宿主入口模式),移除本地路径引用
- 版本统一:EasyAdminBlazor / EasyAdminBlazor.Core / EasyAdminBlazor.Mail 等包版本统一升级到 2.2.16
[v2.2.15] - 2026.08.15
新增功能:后台主题色切换
- 主题色切换器:顶栏新增调色板下拉,内置默认蓝、清新绿、典雅紫、活力橙、中国红 5 种主色,切换即时生效并持久化到本地
- 默认主色配置:
EasyAdminBlazorOptions.DefaultThemeColor 可配置系统默认主色,用户未手动选择时生效
- 全组件主题覆盖:主色按钮、标签页激活、菜单、日历、表单焦点、下拉选中、TinyMCE 编辑器、链接色等跟随主色,深浅色模式均生效
- 登录页主题同步:登录页应用用户保存的主题色或配置的默认主色,与后台保持一致
问题修复
- 用户批量操作逻辑修正:未选择角色/部门/密码时不再直接执行,给出提示;批量操作增加空选保护
- 删除引用保护:角色被用户引用、菜单被角色引用、组织存在子组织或用户时阻止删除,避免脏数据
- 角色保存空权限保护:未选择任何菜单权限时提示,不再保存空权限角色
- 菜单显示按钮状态修正:复选框状态与逻辑保持一致
- 字典导入父级串位修复:多分类导入时字典项不再全部挂到最后一个分类下
- 配置页测试邮件校验修正:只校验 SMTP 配置项,不再因其他配置为空误报;短信测试增加成功/失败/异常反馈
- 任务调度修复:下次运行时间由服务端填充避免索引越界;编辑已有任务时保留原轮次,不再强制覆盖为永久
- 个人资料保存后同步:修改昵称/邮箱/手机后顶栏立即更新,无需刷新
- 文件上传空列表提示:未选择文件时不再提示"成功上传 0 个"
- 选择组件缓存修复:缓存键由表达式引用哈希改为表达式字符串,解决缓存永不命中导致的重复查库
- 操作日志越界保护:无参删除方法不再访问不存在的参数
- 代码生成器容错:程序集扫描增加 ReflectionTypeLoadException 容错,避免页面打不开
- 登录页主题色应用:登录页现在应用用户保存的主题色或配置的默认主色,与后台一致
- 标签页标题本地化:/Admin 标签页标题支持中英文(控制台/Home)
[v2.2.14] - 2026.08.14
依赖升级
- BootstrapBlazor 升级至 10.9.2:修复
ColumnVisibleItem 废弃 API 兼容问题
- FreeSql 相关包统一升级至 3.5.311(
FreeSql.Extensions.AggregateRoot、FreeSql.Extensions.JsonMap、FreeSql.Provider.Sqlite、FreeSql.Provider.MySqlConnector),FreeSql.Cloud 保持最新 2.0.1
安全修复
- 修复站内信存储型 XSS:消息/通知内容渲染前进行服务端 HTML 净化(移除 script、事件属性、
javascript: 链接等),聊天 Markdown 渲染增加 HTML 编码防护
- 修复 AdminSelectTable 数据权限绕过:按已选 Id 回填实体时同样应用数据权限过滤,防止低权限用户越权读取记录
- 修复 ChatHub 身份冒用:SignalR 连接时用登录 Cookie 校验身份,发送消息时校验发送者与登录用户一致,杜绝伪造 userid 冒充他人收发消息
- 修复数据权限 Custom 配置回退为"无可见数据"(fail-closed),避免配置异常时越权看到全部数据
- 登录页安全增强:UAParser 单例复用、IP 解析失败回退
unknown、登录失败计数进程内锁、验证码调试输出清理
问题修复
- 修复强制改密弹窗崩溃:
DialogService.Show 延迟到首帧渲染后调用,避免 BootstrapBlazorRoot 未注册时抛异常;改密成功后自动关闭弹窗并刷新登录态
- 修复打印模块 SQL 方言兼容:分页查询按数据库类型生成
TOP/LIMIT/FETCH FIRST,参数化查询,不再静默吞错
- 修复打印模板目标实体为空:程序集扫描增加
ReflectionTypeLoadException 容错
- 修复报表设计器脚本加载:
eval + 同步 XHR 改为标准 <script> 注入(避免 CSP 拦截、重复加载),生成 HTML 字段名转义
- 修复消息删除越权:删除仅解除当前用户关联,不误删他人消息
- 修复编辑用户密码留空覆盖原密码
- 修复批量删除受保护项被删除:剔除超管/管理员后删除
- 修复权限缓存版本号失效:权限变更后立即失效缓存
- 修复草稿保存不关闭时旧键残留
- 修复 Cron 表达式未校验:新增任务预校验,非法表达式回退 5 秒
- 修复聊天组件资源泄漏:补全定时器与 SignalR 连接释放、beforeunload 引用释放
- 修复邮件服务 HttpClient 泄漏:改用
IHttpClientFactory 管理连接
- 修复新租户管理员未强制改密
- 修复 AdminTable 删除空集合空引用
其他改进
GetConfig 不再抛异常并增加 1 分钟缓存
- 租户数据库类型下拉显式数据源,移除任务调度模板中无消费者的"HTTP请求/清理任务数据"模板
- 新增 XSS 净化等单元测试,测试用例 156 → 160
[v2.2.12] - 2026.06.17
新增:打印模板设计器 (重磅功能)
- 可视化打印模板设计:新增
/Admin/PrintTemplate 页面,用户可通过可视化界面设计打印模板
- 与 AdminTable 联动:如果实体存在对应的打印模板,
AdminTable 自动显示「打印」按钮,选择记录即可一键打印
- 打印服务抽象:新增
PrintService,支持在任何地方调用打印功能
打印设计器增强
- 两列布局插入按钮:模板设计器支持一键插入两列布局,方便设计分栏打印样式
- 中英文多语言支持:完善打印模块的国际化翻译(
zh.json / en.json)
修复
[v2.2.11] - 2026.06.13
架构重构
- 认证中间件拆分:将
EasyAdminAuthStartupFilter(内联 120 行)重构为三个独立中间件,各司其职
AdminRouteSecretMiddleware:管理后台路由混淆保护
AuthCookieMiddleware:Blazor Server Cookie 桥接端点
CookieOptionsHelper:共享 Cookie 安全策略工厂,消除重复代码
- 扩展类命名空间规范化:9 个无命名空间的扩展类(
UtilConvertExtension、StringExtension 等)统一加入 EasyAdminBlazor.Infrastructure.Extensions 命名空间,避免 NuGet 消费者命名空间污染
- 破坏性变更:SysLoginLog.LoginType类型。升级到本版本后,请手动执行:migrate_enum_v.2.2.11.sql
测试覆盖
- 新增单元测试项目
EasyAdminBlazor.Tests(xUnit + Moq + FluentAssertions)
- 150 个测试用例,覆盖安全校验、实体体系、扩展方法、UA 解析、加密工具、日志基础设施
- 测试安全关键路径:重定向防攻击、SSRF 防护、文件魔数校验、PBKDF2/AES 加解密
优化改进
- UAParser 单例化:
AuthService 改为构造注入 UAParser 单例,避免每次登录重新编译正则表达式
OperationLogAttribute 参数截断保护:序列化参数上限 2000 字符,超过自动截断防止撑爆内存
DatabaseLoggerBackgroundService 异常兜底:增加通用异常捕获,防止意外异常导致日志服务永久停止
安全增强
- SSRF 防护修复:
FileSecurityValidator.IsSafeRemoteUri 中 UriHostNameType 非 [Flags] 枚举,误用 HasFlag 导致私有 IP 地址绕过安全校验,已修复
- 管理后台路由 secret 独立为中间件,更可控的管道顺序
国际化
- 枚举值英文化:所有中文枚举成员改为英文(整数值不变,向后兼容)
SysLoginLog.LoginType:{ 登陆成功, 登陆失败 } → { Success, Failure }
SysOrg.OrgType:{ 集团, 公司, 部门, 供应商 } → { Group, Company, Department, Supplier }
OperationResult:{ 成功, 失败 } → { Success, Failure }
OperationType:{ 查询, 添加, 修改, 删除, 导入, 导出 } → { Query, Add, Update, Delete, Import, Export }
问题修复
- 修复草稿计时器不重启:
OnSaveWithoutClose 中 _restartDraftAfterClose 标志在对话框关闭后才设置,导致计时器永不再启动,手动点击也不响应
- 修复导航属性 Nullable 标注:
SysUser.Org、SysOrg.Parent、SysMenu.Parent 等导航属性正确标记为可空,消除 null! 滥用
[v2.2.10] - 2026.06.07
新增功能
- 全新代码生成器:可视化生成 CRUD 页面(仅本地开发环境有效)
- 旧版代码生成器已废弃,请自行添加以下Url为后台菜单:Admin/CodeGenerator
- AdminTable 草稿功能
EnableDraft:自动保存表单数据到 localStorage
EnableSaveWithoutClose:保存后不关闭窗口
DraftAutoSaveInterval:自定义保存间隔(默认 30 秒)
- 编辑框草稿智能恢复:有内容变更才询问,无改动自动清理
- 保存窗口新增「保存不关闭」按钮
优化改进
- 拆分
AdminContext 为多个 partial 类,代码更清晰
- 文件选择组件
AdminFileInput 支持直接复制路径
- 数据库日志改为异步队列写入,减少请求阻塞
- 日志支持批量入库 + 队列大小限制
- 服务停止时自动 flush 剩余日志
FileService 改用 IHttpClientFactory 管理 HttpClient
- 清理 Core 项目中的 nullable 警告
安全增强
- Cookie 认证:移除 JS 读写 fallback,统一通过服务端写入 HttpOnly Cookie
- 开放重定向修复:登录及认证接口安全加固
- SSRF 防护:远程图片保存增加安全检查
- 文件上传:增加真实内容检测,校验流大小限制
- 登录票据改用 ASP.NET Core Data Protection 保护
- 登录限流 IP 获取改为可信代理模式(不再直接信任
X-Forwarded-For)
问题修复
- 修复
AdminContext 中 HttpContext 可能为空的异常
- 优化登录/退出跳转逻辑,兼容 Blazor Server WebSocket 场景
文档更新
- 新增《代码生成器》中英文文档
- 更新《AdminTable》《菜单管理》《数据权限》《项目介绍》文档
[v2.2.9] - 2026.05.30
新增
[v2.2.6] - 2026.05.29
新增
修复
- 避免 Chat 定时器在 DI 已释放时访问服务导致 ObjectDisposedException
- AdminContext 增加 IsAdmin 属性
- 修复 OnBeforeQuery 里
e.Select.OrderByDescending 不生效的问题
- 修复登录没获取到 IP 地址的问题
- 修复没有修改权限时还能切换行内 Switch 的问题
- 修复 BootstrapBlazor 编辑窗口提交按钮一点就 Loading 的问题
- 修正不安装 EasyAdminBlazor.Scheduler 扩展无法登录的问题
重构
- 重构默认排序逻辑
- 优化 FreeSql 非多租户模式下的注册
- 同步 NuGet 版本号
文档
- 新增大量文档:AdminTable、多租户、多语言、数据权限、文件管理等
- 更新快速上手文档
- 增加项目介绍文档
v2.2.0 — 2026.05.23
- 重构:FreeRedis 以扩展方式提供(
EasyAdminBlazor.Redis)
- 重构:计划任务以扩展方式提供(
EasyAdminBlazor.Scheduler)
- 重构:多租户以扩展方式提供(
EasyAdminBlazor.MultiTenant)
- 重构:缓存以扩展方式提供(
EasyAdminBlazor.FusionCache)
- 重构:FusionCache 作为扩展项目提供
v2.0.x — 2026.05.22 ~ 2026.05.23
v2.0.x — 2026.04.09 ~ 2026.04.15
- 重构:架构分层,数据跟 UI 分开,以适应多层架构
- 新增:登录增加登录城市记录
- 优化:完全适配移动端
- 修复:移除 BootstrapBlazor 的 WebClient,解决超时异常
- 增强:
AdminSelectEntity.razor 改为可绑定任意字段
- 修复:保存异常时不能再次点击保存
- 修复:修正
OrgId 硬编码问题,Flags 类型匹配时优先取 Column(Name=值)
- 增强:表格的筛选和高级查询增加 Flags 枚举支持
v2.0.x — 2026.03.01 ~ 2026.03.20
- 新增:给文件上传 Picker 增加权限
- 新增:通过安全码访问后台
- 新增:增加 SendCloud 邮件发送
- 修复:解决多项目任务计划添加失败问题
v2.0.x — 2025.12.31 ~ 2026.02.22
- 优化:TinyMCE 不能修改图片 alt 的问题
- 新增:菜单增加是否显示隐藏
v2.0.3 — 2026.01.03
- 集成:直接集成 FusionCache
- 增强:缓存增加
GetOrSet 方法
v2.0.1 — 2026.01.01
- 增强:管理员列表增加是否有效快速更改项
- 增强:加密密钥可自定义
- 增强:加密登录 Cookie
- 增强:验证码和登录错误次数在配置 Redis 的情况下用 Redis 存储,没有 Redis 则用内存存储
v2.0.0 — 2025.12.31
- 升级:升级为 .NET 10
- 升级:升级所有 NuGet 包到最新版
v1.4.7 — 2025.06.06 ~ 2025.11.25
- 新增:上传参数可配置
- 增强:更改树形组件的排序属性为 string 类型
- 修复:修复模糊查询不出记录的问题
- 新增:增加图片验证码扩展(
EasyAdminBlazor.Captcha)
- 修复:修复组织负责人不能指定的问题
- 新增:增加微信接入扩展(
EasyAdminBlazor.WeChat)
- 优化:整体优化与 bug 修复
[1.4.6] - 2025-06-02
新增功能
- 编辑器增加粘贴上传功能
- 编辑器增加远程图片下载和本地图片拖动上传功能
- AdminTable组件增加根据字典数据自定义导入方法
修复问题
[1.4.5] - 2025-06-01
新增功能
- 增加菜单收藏功能
- 登录验证码增加可配置是否显示
- 系统名称增加可配置是否显示
- 帮助链接增加可配置是否显示
- 消息中心增加可配置是否显示
- 增加AdminSelectTreeEntity组件
- 增加字典多选组件AdminDictMultiSelect
- 增加AdminTree组件(可根据实体生成树,不用查询数据再绑定,其它Admin开头的数据类组件都是这个效果)
- AdminTable组件增加根据字典数据自定义导入方法
[1.4.0] - 2025-05-29
新增功能
- 优化页面权限验证
- 增加默认租户ID
- 消息提醒查看增加上一条下一条
- 将聊天组件单独作为扩展项目
- 增加强制用户修改密码功能
- 增加可上传类型提示
- 优化文件上传逻辑,增强文件上传安全检查
- 将邮件发送,短信发送,富文本编辑器独立成扩展方便后期更换
- 文件选择样式调整
- 任务计划增加日志查看
[1.3.0] - 2025-05-26
新增功能
[1.2.0] - 2025-05-25
新增功能
- 增加站内信
- 增加系统通知
- 风格调整
- 文件选择、富文本及其它组件夜间模式完善
[1.1.0] - 2025-05-22
新增功能
- 用户增加批量设置角色、部门、重置密码功能
- 组织架构增加负责人绑定
- 增加组织结构图
- 增加字典批量导入导出
- AdminSelectTable组件增加Id绑定
@bind-ValueId="v.ArticleId"
修复问题
- 修正租户ORM对象偶尔丢失问题(改为每次URL改变后重新获取)
- 登录成功后未重置密码错误计数
- 修正功能菜单单个选择时未返回选中项问题
[1.0.0] - 2025-05-15
初始版本