基于EFCore5的带迁移权限管理类库发布相关问题咨询
基于EFCore的权限管理类库分发核心问题实操解答
一、类库内嵌迁移的执行方式
首先明确:用户不能直接在PM控制台裸跑Update-Database命令完成类库表结构生成,原因和正确操作如下:
- EFCore的迁移命令默认绑定启动项目内直接定义的DbContext,类库内嵌的
PermissionContext不会被自动识别,直接运行无参数的Update-Database大概率会报“找不到指定DbContext”的错误。 - 如果没有做封装,用户手动执行命令时必须补充两个关键参数:
命令执行时会自动读取用户项目配置的连接字符串,在用户的自有数据库中应用类库内嵌的所有迁移,生成权限相关的表结构。Update-Database -Context PermissionContext -StartupProject 用户自有业务项目 - 从类库体验角度优化:不要要求用户手动定位类库项目执行迁移,所有迁移逻辑都绑定用户的启动项目执行即可,类库项目本身不需要具备可执行入口。
二、连接字符串的传入逻辑与依赖要求
你目前写的让用户手动注册PermissionContext的方式对终端用户负担过重,完全可以做封装简化,对应规则如下:
- 类库侧可以封装统一的服务扩展方法,把
PermissionContext的注册、迁移程序集指向、SQLServer提供器配置等逻辑全部藏在类库内部,用户只需要一行代码传入连接字符串即可完成配置,根本不需要手动编写那段AddDbContext的冗余代码。 - 如果坚持让用户按原始方式手动注册
PermissionContext,用户必须单独安装Microsoft.EntityFrameworkCore.SqlServerNuGet包,否则代码里的UseSqlServer扩展方法会报找不到的编译错误——这种体验是类库分发的大忌,一定要通过封装把这部分依赖的引用逻辑屏蔽掉。 - 优化后的用户接入代码应该简化为类似格式:
不需要用户手动处理迁移程序集路径、DbContext注册这些和业务无关的逻辑。services.AddMicroPermissions(opt => { opt.UseSqlServer(Configuration.GetConnectionString("权限模块数据库连接串")); });
三、不同ORM栈下的依赖拉取规则
针对已经使用Dapper等其他ORM的用户场景,依赖的安装逻辑非常清晰:
- 只要你在类库项目文件中,将所有EFCore相关的依赖(EFCore核心包、SQLServer提供器包、迁移组件包)设置为普通的PackageReference,不添加
PrivateAssets="All"的标记,用户安装你的主权限类库时,NuGet会自动解析并拉取所有需要的EFCore依赖,完全不需要用户手动额外安装。 - Dapper和EFCore不会产生冲突,两套ORM可以在同一个项目内共存运行,用户不需要为了接入你的类库调整已有的ORM使用逻辑,只要依赖版本解析没有冲突,所有组件都会被自动正确安装。
内容的提问来源于stack exchange,提问作者Alen Smith
相关产品推荐
相关产品推荐

