.NET 4.0 EFv4项目dotnet build后无法加载指定元数据资源

核心问题原因 #

Visual Studio使用旧版MSBuild工具链构建时，会自动从.edmx文件中提取**CSDL（概念模型）、SSDL（存储模型）、MSL（映射文件）**这三个元数据文件，并将它们作为嵌入式资源嵌入到程序集里；但dotnet build使用的新SDK风格MSBuild工具链，默认不支持旧版EFv4项目的.edmx元数据自动提取逻辑，导致这三个关键资源缺失，最终运行时触发Unable to load the specified metadata resource错误。

解决方案 #

方案1：手动提取并嵌入元数据文件 #

1. 提取元数据内容
   用文本编辑器打开MyDB.edmx文件，分别提取以下三部分内容并保存为独立文件：

   • 找到<edmx:ConceptualModels>节点内的所有内容，保存为MyDB.csdl
   • 找到<edmx:StorageModels>节点内的所有内容，保存为MyDB.ssdl
   • 找到<edmx:Mappings>节点内的所有内容，保存为MyDB.msl

2. 修改项目文件添加资源
   在EFProject的项目文件中，将这三个新文件添加到EmbeddedResource组：

   <ItemGroup>
       <EmbeddedResource Include="MyDB.edmx" />
       <EmbeddedResource Include="MyDB.Designer.cs" />
       <EmbeddedResource Include="MyDB.csdl" />
       <EmbeddedResource Include="MyDB.ssdl" />
       <EmbeddedResource Include="MyDB.msl" />
   </ItemGroup>
   

3. 修正连接字符串
   确保app.config中的连接字符串明确指向这三个资源（或使用res://*/自动匹配）：

   <add name="MyDBConnectionString" 
        connectionString="metadata=res://*/MyDB.csdl|res://*/MyDB.ssdl|res://*/MyDB.msl;provider=System.Data.SqlClient;provider connection string=&quot;..." />
   

方案2：使用旧版MSBuild构建项目 #

直接使用Visual Studio自带的旧版MSBuild工具构建该项目，它能自动处理.edmx的元数据提取：

1. 找到VS安装目录下的msbuild.exe（例如VS2019的路径为C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\msbuild.exe）
2. 在命令行执行构建命令：

   msbuild EFProject.csproj /t:Build /p:Configuration=Release
   

补充说明 #

反编译时看不到CSDL文件是正常的——Visual Studio构建时会自动生成并嵌入这些文件，但dotnet build没有执行这个步骤，所以程序集里缺少这些关键元数据资源，EF运行时无法加载，才会报错。这些元数据文件是EFv4运行必需的，必须存在于程序集的嵌入式资源中。

内容的提问来源于stack exchange，提问作者Guy E