dotnet ef migrations add 未生成文件主因是EF Core未识别DbContext，需确认工作目录、DbContext注册及构造函数；database update失败多因迁移类缺失或命名错误，应检查.csproj包含规则和时间戳前缀。
dotnet ef migrations add 为什么没生成文件
常见现象是命令执行后控制台显示“Done.”，但项目里找不到 Migrations 文件夹或新迁移类。根本原因通常是 EF Core 没识别到你的 DbContext 类型，或者启动项目/配置上下文的方式不对。
- 确保当前命令行工作目录是包含
.csproj的项目根目录（不是解决方案目录） - 检查
DbContext是否有公开无参构造函数，或是否在Startup.cs/Program.cs中通过services.AddDbContext<yourdbcontext>()</yourdbcontext>正确注册 - 如果 DbContext 在独立类库中，必须用
--project和--startup-project显式指定：dotnet ef migrations add Init --project Data.csproj --startup-project WebApi.csproj - EF Core 6+ 要求
IDesignTimeDbContextFactory实现仅在无法自动解析 DbContext 时才需要，别一上来就写——多数情况是注册或路径错了
dotnet ef database update 执行失败：No migrations found
命令报错 No migrations found，说明 EF Core 查不到已生成的迁移类，不是数据库没更新，而是它压根没找到迁移记录源。
- 确认
Migrations文件夹在项目中且被包含进编译（.csproj 里有<compile include="Migrations\**"></compile>或默认包含规则生效） - 迁移类名必须以时间戳开头（如
20231015123456_Init.cs），手动改过名字会导致跳过 - 如果项目用了多目标框架（
<targetframeworks>net6.0;net8.0</targetframeworks>），EF 可能因默认选错 TF 而找不到上下文——加--framework net8.0显式指定 - 运行前先执行
dotnet build，避免因编译缓存导致迁移程序集未加载
迁移后表结构没变，但数据库里多了 __EFMigrationsHistory 表
这说明迁移“执行成功”了，但实际 SQL 没生效。最常见原因是迁移类里的 Up(MigrationBuilder migrationBuilder) 方法体为空，或只调用了 migrationBuilder.Sql(...) 却忘了加 suppressTransaction: false（默认为 true，SQL 不在事务里执行，出错也不回滚）。
- 打开刚生成的迁移类，检查
Up方法是否真有migrationBuilder.CreateTable、AddColumn等调用；空方法不会报错，但什么也不做 - 如果是从已有数据库反向生成迁移（
dotnet ef migrations add Init --no-transactions），默认会把所有建表语句包进一个事务——若某张表已存在，整个迁移失败且静默回滚，得加--no-transactions或手动删掉重复建表逻辑 - SQLite 迁移不支持某些操作（如重命名列），对应代码会被跳过且不提示，得查日志或启用 EF 日志：
options.LogTo(Console.WriteLine)
生产环境怎么安全执行 migration update
本地跑通不等于线上能直接 update。EF Core 的 database update 默认连目标库、开事务、执行所有待应用迁移——但生产库往往禁止直接 DDL 权限，或要求 SQL 经 DBA 审核。
- 永远先用
dotnet ef migrations script生成 SQL 脚本再人工审核：dotnet ef migrations script --idempotent --output deploy.sql -
--idempotent保证脚本能多次运行不报错（加了 IF NOT EXISTS 等判断），但不解决逻辑冲突（比如两次迁移都改同一列类型） - 避免在生产环境用
--connection直连执行——连接字符串硬编码或泄露风险高；应通过环境变量注入，并确保部署账号只有 DML + 必要 DDL 权限 - SQL Server 上，
ALTER TABLE ... ALTER COLUMN若涉及数据转换（如nvarchar(50)→int），EF 生成的脚本不会校验存量数据，上线前必须手动验证或加 CHECK 约束
