.NET 7下含DLL引用的API项目Dockerfile正确构建及警告解决

我用.NET 7开发API项目，该项目引用同目录下的类库项目。编写的Dockerfile能完成构建且应用正常运行，但构建时出现大量NETSDK1004警告，提示Assets文件未找到，尽管日志显示两个项目均已完成还原。

原Dockerfile #

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /app

# Copy everything
COPY . ./
# Restore as distinct layers
RUN dotnet restore myApiSubFolder
# Build and publish a release
RUN dotnet publish myApiSubFolder -c Release -o out

# Build runtime image
FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /app
COPY --from=build-env /app/out .
COPY myApiSubFolder/version.txt .
ENTRYPOINT ["dotnet", "myAPi.dll"]
EXPOSE 5000

构建警告日志片段 #

Step 4/11 : RUN dotnet restore ApiProject
 ---> Running in a510cc167168
  Determining projects to restore...
  Restored /app/DllProject/DllProject.csproj (in 2.17 sec).
  Restored /app/ApiProject/ApiProject.csproj (in 2.17 sec).
...
Step 5/11 : RUN dotnet publish ApiProject -c Release -o out
 ---> Running in b678b3120d93
MSBuild version 17.4.1+9a89d02ff for .NET
  Determining projects to restore...
  All projects are up-to-date for restore.
/usr/share/dotnet/sdk/7.0.102/Sdks/Microsoft.NET.Sdk/targets/Microsoft.PackageDependencyResolution.targets(267,5): warning NETSDK1004: Assets file'/root/.nuget/packages/microsoft.aspnetcore/2.2.0/lib/netst> .. not found. Run a NuGet package restore to generate this file. [/app/DllProject/DllProject.csproj]
...
# 大量类似警告省略
DllProject -> /app/DllProject/bin/Release/net7.0/DllProject.dll
  ApiProject -> /app/ApiProject/bin/Release/net7.0/ApiProject.dll
  ApiProject -> /app/out/

解决方案：优化分层构建流程 #

问题根源在于原构建流程中，dotnet restore仅针对API项目，且提前复制所有文件导致依赖缓存失效，MSBuild在publish时无法找到类库项目正确的Assets文件。修改后的Dockerfile采用分层构建+先复制项目文件再还原的方式，既消除警告，又提升构建效率：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /app

# 1. 先复制所有项目的csproj文件，利用Docker缓存
COPY ApiProject/ApiProject.csproj ./ApiProject/
COPY DllProject/DllProject.csproj ./DllProject/

# 2. 针对所有项目执行还原，确保生成完整的Assets文件
RUN dotnet restore ApiProject/ApiProject.csproj

# 3. 复制所有项目文件
COPY . ./

# 4. 发布API项目，自动处理依赖的类库项目
RUN dotnet publish ApiProject/ApiProject.csproj -c Release -o out

# 构建运行时镜像
FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /app
COPY --from=build-env /app/out .
COPY ApiProject/version.txt .
# 注意保持DLL文件名与项目名一致，避免大小写问题
ENTRYPOINT ["dotnet", "ApiProject.dll"]
EXPOSE 5000

关键优化点 #

• 分层复制项目文件：先复制.csproj文件再执行dotnet restore，只有当项目依赖配置变化时才会重新执行还原，利用Docker缓存大幅缩短构建时间。
• 完整还原所有项目：通过指定API项目的csproj执行dotnet restore，会自动还原其依赖的类库项目，确保所有项目的Assets文件正确生成。
• 统一文件名大小写：修正原Dockerfile中myAPi.dll的大小写问题，与实际项目输出文件名保持一致。

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