运行项目报错：应用配置文件中找不到名为'SPOEntities'的连接字符串

• 确认配置文件归属与结构
  • 若你的EF上下文定义在类库项目中，连接字符串必须放在启动项目的配置文件里，类库自身的app.config默认不会被运行环境加载
  • 检查连接字符串节点拼写：<connectionStrings>为复数格式，name属性值完全匹配SPOEntities，大小写完全一致
  • 若使用EF Database First/Model First模式，确认providerName属性值为System.Data.EntityClient，而非普通ADO.NET的System.Data.SqlClient
  • 节点层级必须正确，示例配置如下：

  <configuration>
    <!-- configSections节点必须是configuration的第一个子节点 -->
    <configSections>
      <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework" requirePermission="false"/>
    </configSections>
    <connectionStrings>
      <add name="SPOEntities" 
           connectionString="metadata=res://*/xxx.csdl|res://*/xxx.ssdl|res://*/xxx.msl;provider=System.Data.SqlClient;provider connection string=&quot;data source=你的数据库地址;initial catalog=你的库名;integrated security=True;MultipleActiveResultSets=True&quot;" 
           providerName="System.Data.EntityClient" />
    </connectionStrings>
  </configuration>
  

  • 若启动项目为ASP.NET/WebForms类Web项目，需将配置放在web.config中，Web项目默认不会读取app.config配置
• 检查配置文件生成属性
  • 右键启动项目下的配置文件，选择「属性」，确认复制到输出目录选项设置为如果较新则复制或始终复制
  • 编译完成后打开输出目录（bin/Debug、bin/Release），找到生成后的[程序集名].exe.config（桌面项目）或[程序集名].dll.config（类库），确认文件内确实存在目标连接字符串节点
• 校验EF上下文配置
  • 检查SPOEntities上下文构造函数是否正确引用配置名，示例：

  public partial class SPOEntities : DbContext
  {
      public SPOEntities() : base("name=SPOEntities")
      {
      }
  }
  

  • 确认没有硬编码连接字符串、自定义DbConfiguration动态覆盖连接配置的逻辑
• 清理缓存重试
  • 右键解决方案选择「清理解决方案」，手动删除所有项目下的bin、obj文件夹后重新编译运行，排除旧编译缓存影响
  • 若使用IIS/IIS Express运行，需先停止站点，清理站点临时缓存后再启动运行

内容的提问来源于stack exchange，提问作者Asaf Ben Shabat