ASP.NET Core 6创建迁移时出现'appsettings.json'未找到且非可选错误，指定路径及设置复制属性无效

我之前在做EF Core迁移时也碰到过一模一样的头疼问题——明明设置了文件复制属性，代码里也指定了路径，结果还是报"The configuration file 'appsettings.json' was not found and is not optional"。折腾了好一会儿，总结出几个靠谱的解决方案，你可以挨个试试：

1. 确认迁移命令的工作目录和启动项目 #

这是最容易忽略但最常见的原因！

• 如果用Package Manager Console：一定要确认顶部的「默认项目」下拉框选的是你的Web项目（不是存放DbContext的类库项目），EF迁移需要读取Web项目里的配置文件。
• 如果用dotnet CLI：先通过cd命令切换到你的Web项目根目录，再执行迁移命令。如果DbContext在类库项目，记得加上--startup-project参数指定Web项目路径，比如：

  dotnet ef migrations add InitialCreate --startup-project ../YourWebAppName
  

2. 在DbContext中显式加载配置文件 #

有时候默认的配置加载逻辑在迁移场景下会失效，你可以在OnConfiguring方法里手动构建配置，确保路径绝对正确：

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using System.IO;

public class YourDbContext : DbContext
{
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            // 若DbContext在类库项目，需用相对路径跳转到Web项目根目录
            var webProjectRoot = Path.GetFullPath(Path.Combine(Directory.GetCurrentDirectory(), "../YourWebAppName"));
            
            var configuration = new ConfigurationBuilder()
                .SetBasePath(webProjectRoot) // Web项目直接用Directory.GetCurrentDirectory()即可
                .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
                .Build();
            
            optionsBuilder.UseSqlServer(configuration.GetConnectionString("DefaultConnection"));
        }
    }
}

3. 再次确认appsettings.json的复制配置 #

虽然你说已经设置了「始终复制」，但还是可以检查一下项目文件的底层配置是否生效：

• 右键appsettings.json → 属性，确认「复制到输出目录」是始终复制或如果较新则复制。
• 也可以直接编辑.csproj文件，确保有这段配置：

  <ItemGroup>
    <None Update="appsettings.json">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
  </ItemGroup>
  

4. 指定迁移时的环境 #

如果你的项目区分了环境配置（比如appsettings.Development.json），迁移时可能默认用了Production环境，导致找不到对应文件。可以在命令里指定环境：

# CLI命令
dotnet ef migrations add InitialCreate --environment Development

# Package Manager Console命令
$env:ASPNETCORE_ENVIRONMENT = "Development"; Add-Migration InitialCreate

5. 清理重建项目 #

有时候输出目录的旧文件会干扰配置读取，试试：

• 右键项目 → 清理
• 右键项目 → 生成
• 手动删除bin和obj目录，再重新生成项目

一般来说，前两个方案就能解决大部分问题，尤其是确认启动项目和工作目录这一步，很多人都容易踩坑。

内容的提问来源于stack exchange，提问作者Emre Koçoğlu