.NET Core项目发布遇NETSDK1047错误，咨询csproj与引用关联问题

先来说你遇到的发布错误，再拆解背后的核心机制，帮你彻底搞明白问题根源。

错误原因分析 #

你发布AWS Lambda时碰到的error NETSDK1047，核心问题是：AWS Lambda默认运行在Linux环境（对应linux-x64运行时标识符），但你的项目在NuGet还原阶段，没有生成针对该运行时的资产配置。

本地构建正常是因为Windows环境下默认使用的是Windows对应的运行时（比如win-x64），而你的project.assets.json里仅包含了通用的.NETCoreApp,Version=v3.1目标，没有针对linux-x64的具体依赖资产条目，导致发布时找不到匹配的运行时配置。

快速解决步骤 #

1. 更新csproj配置 #

在项目的<PropertyGroup>节点中添加运行时标识符配置，让NuGet还原时生成对应环境的资产：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
    <AWSProjectType>Lambda</AWSProjectType>
    <!-- 同时兼容本地Windows开发和Lambda Linux运行环境 -->
    <RuntimeIdentifiers>linux-x64;win-x64</RuntimeIdentifiers>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Amazon.Lambda.Core" Version="1.1.0" />
    <PackageReference Include="Amazon.Lambda.Serialization.SystemTextJson" Version="2.0.0" />
    <PackageReference Include="Amazon.Lambda.SQSEvents" Version="1.1.0" />
  </ItemGroup>
</Project>

如果仅需针对Lambda发布，也可以只添加单数形式的<RuntimeIdentifier>linux-x64</RuntimeIdentifier>。

2. 重新执行NuGet还原 #

• 在Visual Studio中：右键项目 → 还原NuGet包
• 或命令行方式：在项目根目录运行

dotnet restore

这一步会重新生成obj/project.assets.json，此时文件中会新增.NETCoreApp,Version=v3.1/linux-x64的目标条目，包含Linux运行时所需的依赖资产信息。

3. 重新发布项目 #

现在再尝试发布AWS Lambda，应该就能顺利完成了。

csproj与project.assets.json的协同机制 #

搞清楚这两个文件的分工，以后遇到类似依赖问题就不会迷茫了：

1. csproj是项目的「配置指挥中心」：

   • 它定义了项目的核心规则：目标框架（如netcoreapp3.1）、支持的运行时环境、依赖包版本、项目类型等。
   • 所有还原、构建、发布操作，都是基于csproj里的配置来执行的。

2. project.assets.json是NuGet还原的「执行结果清单」：

   • 当你执行dotnet restore时，NuGet会读取csproj的配置，解析所有直接/间接依赖，然后生成这个文件。
   • 它记录了：针对不同目标框架、不同运行时的依赖包具体路径、版本、编译/运行时所需的DLL文件等细节。
   • 后续的构建（dotnet build）和发布（dotnet publish）都会依赖这个清单来找到正确的依赖文件，确保输出的程序能在指定环境正常运行。

3. 核心协同逻辑：

   • csproj告诉NuGet「我需要什么环境、什么依赖」，NuGet通过还原操作把这些需求转化为具体的可执行资产清单（project.assets.json），最后由构建/发布工具根据清单组装出符合要求的程序包。

你的问题本质就是csproj里没声明需要支持linux-x64运行时，导致NuGet还原时没生成对应条目，发布Lambda时自然找不到所需的资产配置。

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