dotnet test在Docker构建阶段失败，本地运行一切正常

问题背景 #

接手一个.NET 6项目，包含4个业务子项目+1个独立测试子项目。本地（JetBrains Rider/Visual Studio/终端dotnet test）测试全部通过，但Docker构建阶段执行dotnet test时，测试进程崩溃，抛出System.NullReferenceException，指向未初始化的Mock对象，推测标注[OneTimeSetUp]/[SetUp]的测试初始化方法未正常执行。

Dockerfile内容 #

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

FROM mcr.microsoft.com/dotnet/sdk:6.0.402 AS build
WORKDIR /src
COPY ["<company>.Web.csproj", "<company>.Web/"]
COPY ["<company>.Business.csproj", "<company>.Business/"]
COPY ["<company>.Storage.csproj", "<company>.Storage/"]
COPY ["<company>.Middleware.csproj", "<company>.Middleware/"]
COPY ["<company>.WebTest.csproj", "<company>.WebTest/"]
RUN dotnet restore "<company>.Web.csproj"
COPY . .
WORKDIR "/src/<company>.Web"
RUN dotnet build "<company>.Web.csproj" -c Release -o /app/build

FROM build AS test
WORKDIR "/src/<company>.WebTest"
RUN dotnet test

FROM test AS publish
WORKDIR "/src/<company>.Web"
RUN dotnet publish "<company>.Web.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "<company>.Web.dll"]

Docker构建错误日志 #

#21 6.356 Starting test execution, please wait...
#21 6.373 A total of 1 test files matched the specified pattern.
#21 7.413 The active test run was aborted. Reason: Test host process crashed : Unhandled exception. Unhandled exception. System.NullReferenceException: Object reference not set to an instance of an object.

排查思路 #

1. 对齐测试构建配置与环境版本 #

• Docker中dotnet test默认使用Debug配置，而本地可能用Release运行测试，执行命令时显式指定配置：RUN dotnet test -c Release，避免配置差异导致初始化逻辑跳过。
• 对比本地与Docker的.NET SDK版本：执行本地dotnet --version，确认是否与Docker镜像的6.0.402一致，版本差异可能引发兼容性问题。
• 检查测试项目的NuGet依赖：确保NUnit和NUnit3TestAdapter版本与.NET 6兼容，这两个包是NUnit测试在dotnet test中正常运行的必要条件。

2. 获取详细测试日志定位问题点 #

• 修改Docker中测试命令，添加详细日志参数：RUN dotnet test -c Release -v detailed，查看具体是哪个测试类/方法抛出异常，以及初始化方法的执行状态，精准定位未初始化的Mock对象。
• 若测试项目未被正确构建，可在测试阶段先构建再执行：RUN dotnet build -c Release && dotnet test -c Release。

3. 检查初始化方法的合法性 #

• NUnit的[OneTimeSetUp]/[SetUp]方法必须是public修饰符，否则测试运行时不会执行。检查你的初始化方法是否为private，本地IDE可能存在特殊处理，但Docker环境严格遵循框架规则。
• 排查测试类是否存在[Ignore]等跳过初始化的属性，或是基类初始化方法依赖本地资源（Docker中缺失）导致执行失败。

4. 确认测试依赖文件是否完整 #

• 检查测试项目的配置文件（如appsettings.json）、测试数据文件是否被COPY . .指令正确复制到Docker镜像的/src/<company>.WebTest目录下。
• 查看测试项目.csproj文件，确保依赖文件的CopyToOutputDirectory设置为Always或PreserveNewest，保证构建时文件被复制到输出目录，测试执行时可访问。

5. 禁用测试并行执行验证 #

• NUnit默认并行执行测试，若初始化方法非线程安全或Mock对象为共享实例，可能在并行环境下出现初始化不完整。在测试类添加属性禁用并行：

  [TestFixture]
  [Parallelizable(ParallelScope.None)]
  public class YourTestClass
  {
      // 测试代码
  }
  

  或直接修改Docker命令：RUN dotnet test -c Release --no-parallel。

6. 排查平台环境差异 #

• Docker镜像基于Linux，本地可能是Windows/macOS，注意文件路径大小写问题（Linux区分大小写），若初始化代码中引用了大小写错误的文件路径，会导致加载失败。
• 检查测试是否依赖本地环境变量，在Dockerfile的test阶段添加对应变量：ENV YOUR_VAR=target_value。

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