升级Visual Studio与ASP.NET Core7.0.7后Docker构建失败求助

在搭载最新系统版本、已完成所有软件升级的iMac Pro上使用Docker Desktop for MAC，通过3个自定义Dockerfile构建ASP.NET Core 7.0 Web应用，此前6个月运行完全正常。升级Visual Studio和ASP.NET Core 7.0.7后，执行项目镜像构建时出现失败，错误信息如下：

------
DockerfileBuildBaseImage-AMS.Portal.Server.Web:34
--------------------
  32 |     
  33 |     COPY . ./
  34 | >>> RUN dotnet publish Code/AMS_WebUI/AMS_Portal/AMS.Portal.Server.Web/AMS.Portal.Server.Web.csproj -c Release -o AMS.Portal.Server.Web/out
  35 |     
  36 |     FROM aspnetcore7:latest
--------------------
ERROR: failed to solve: process "/bin/sh -c dotnet publish Code/AMS_WebUI/AMS_Portal/AMS.Portal.Server.Web/AMS.Portal.Server.Web.csproj -c Release -o AMS.Portal.Server.Web/out" did not complete successfully: exit code: 1

终端仅显示代码警告（如warning BL0005: Component parameter 'Expanded' should not be set outside of its component），无其他错误信息，而这些警告本身不会导致构建失败。

1. 对齐SDK镜像与本地项目的.NET版本 #

你自定义的aspnetcore7_sdk镜像使用的是SDK 7.0.304，对应ASP.NET Core 7.0.7。但升级Visual Studio后，本地项目可能自动引用了更高版本的.NET依赖包（比如7.0系列的后续小版本），容器内的旧SDK版本无法兼容这些新依赖，从而触发隐性失败。

• 解决方式：
  • 检查本地项目根目录的global.json文件，添加或修改内容锁定SDK版本为7.0.304，确保和容器内SDK版本一致：

    {
      "sdk": {
        "version": "7.0.304"
      }
    }
    

  • 或者更新自定义SDK镜像的DOTNET_SDK_VERSION为本地当前使用的7.0系列SDK版本，重新构建aspnetcore7_sdk镜像。

2. 修复发布命令的依赖处理逻辑 #

直接发布单个csproj文件时，若跳过依赖还原步骤，可能因为缺少项目依赖的其他项目或NuGet包导致失败，这类错误往往不会显式输出，但会返回exit code 1。

• 解决方式：
  修改Dockerfile中的发布步骤，先执行依赖还原再发布：

  COPY . ./
  RUN dotnet restore Code/AMS_WebUI/AMS_Portal/AMS.Portal.Server.Web/AMS.Portal.Server.Web.csproj
  RUN dotnet publish Code/AMS_WebUI/AMS_Portal/AMS.Portal.Server.Web/AMS.Portal.Server.Web.csproj -c Release -o AMS.Portal.Server.Web/out --no-restore
  

  或者添加--verbosity detailed参数获取完整日志，定位隐藏错误：

  COPY . ./
  RUN dotnet publish Code/AMS_WebUI/AMS_Portal/AMS.Portal.Server.Web/AMS.Portal.Server.Web.csproj -c Release -o AMS.Portal.Server.Web/out --verbosity detailed
  

3. 清理缓存消除版本冲突 #

升级后，Docker缓存的旧镜像层、本地NuGet缓存可能存在版本残留，导致构建时出现隐性冲突。

• 解决方式：
  • 强制不使用Docker缓存重新构建项目镜像：

    docker build --no-cache -f ./Docker/Generated/Build/DockerfileBuildBaseImage-AMS.Portal.Server.Web -t ams_portal_server .
    

  • 本地清理NuGet缓存后再执行构建：

    dotnet nuget locals all --clear
    

4. 检查项目TargetFramework配置 #

确认项目的.csproj文件中TargetFramework字段为net7.0，且未指定与容器不兼容的运行时标识（RID），避免发布时出现运行环境不匹配的隐性错误。

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