ASP.NET 7 Docker容器中NuGet还原版本错误排查求助

问题根源 #

核心问题是Docker构建过程中，间接依赖将Microsoft.EntityFrameworkCore从指定的7.0.4升级到了8.0.23，进而导致Microsoft.Extensions.DependencyInjection.Abstractions版本不匹配（Autofac需要8.0但容器只有7.0）。本地运行正常是因为本地NuGet缓存或项目依赖锁定机制阻止了版本升级，而Docker是干净环境，间接依赖触发了版本提升。

具体解决方案 #

1. 锁定所有EF Core相关包版本（包括Pomelo） #

Pomelo.EntityFrameworkCore.MySql的版本必须与EF Core主版本严格对应：7.x版本的Pomelo仅兼容7.x的EF Core，若使用8.x的Pomelo会自动拉取EF Core 8.0。在你的csproj中明确指定Pomelo的版本为7.x系列：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

  <ItemGroup>
    <!-- 明确指定EF Core版本 -->
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="7.0.4" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="7.0.4">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
    </PackageReference>
    <!-- 指定兼容.NET7的Pomelo版本 -->
    <PackageReference Include="Pomelo.EntityFrameworkCore.MySql" Version="7.0.0" />
    <!-- 锁定Autofac及扩展包版本为.NET7兼容版 -->
    <PackageReference Include="Autofac" Version="7.1.0" />
    <PackageReference Include="Autofac.Extensions.DependencyInjection" Version="7.1.0" />
    <!-- Swagger包保持.NET7兼容 -->
    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
  </ItemGroup>
</Project>

2. 确保Dockerfile使用.NET7基础镜像 #

检查Dockerfile中的SDK和运行时镜像，必须使用7.0标签，不能误用8.0或最新标签：

# 构建阶段使用.NET7 SDK
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["YourApiProject.csproj", "."]
RUN dotnet restore "./YourApiProject.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "YourApiProject.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "YourApiProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段使用.NET7 ASP.NET运行时
FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "YourApiProject.dll"]

3. 强制锁定依赖版本（可选但推荐） #

创建Directory.Packages.props文件放在项目根目录，统一管理所有包版本，避免间接依赖偷偷升级：

<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
  <ItemGroup>
    <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="7.0.4" />
    <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="7.0.4" />
    <PackageVersion Include="Pomelo.EntityFrameworkCore.MySql" Version="7.0.0" />
    <PackageVersion Include="Autofac" Version="7.1.0" />
    <PackageVersion Include="Autofac.Extensions.DependencyInjection" Version="7.1.0" />
    <PackageVersion Include="Swashbuckle.AspNetCore" Version="6.4.0" />
  </ItemGroup>
</Project>

4. 清理Docker构建缓存 #

之前的构建缓存可能残留了8.0版本的依赖，执行以下命令重新构建：

docker build --no-cache -t your-api-image .

5. 验证依赖树 #

在本地执行以下命令检查依赖树，确认没有EF Core 8.0的间接依赖：

dotnet list package --include-transitive

如果发现有包依赖EF Core 8.0，找到对应的包并降级到兼容.NET7的版本。

关键说明 #

• 本地运行时bin/Debug/net7.0中没有Microsoft.Extensions.DependencyInjection.Abstractions是因为该包被.NET7 SDK的共享框架包含，不需要复制到输出目录；而Docker运行时如果依赖版本不匹配，就会触发找不到程序集的异常。
• 版本号中的方括号[7.0.4]表示允许小版本升级（比如7.0.5），但如果第三方包依赖更高主版本（8.0），NuGet仍会优先满足更高版本的依赖，因此必须明确锁定主版本。

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