Docker中构建含BundlerMinifier的.NET6项目时遇空引用异常

问题重现 #

将.NET6应用Docker化过程中，使用BuildBundlerMinifier打包JS文件时触发「object reference」空引用异常，构建步骤失败且无详细错误信息。相关配置如下：

bundleconfig.json #

[
 {
"outputFileName": "wwwroot/js/site.min.js",
"inputFiles": [
  "wwwroot/js/site.js"
],
"minify": {
  "enabled": true,
  "renameLocals": true,
  "alwaysEscapeNonAscii": true,
  "gzip": false,
  "preserveImportantComments": false
 }}
]

Dockerfile片段 #

RUN dotnet add package BuildBundlerMinifier
RUN dotnet restore "View.Site.csproj"
RUN dotnet build "View.Site.csproj" -c Release -o /app/build

排查与解决步骤 #

1. 验证输入文件是否存在于构建上下文 #

空引用异常常见原因是BundlerMinifier找不到指定的输入文件：

• 确认wwwroot/js/site.js存在于Docker构建上下文（Dockerfile所在目录或子目录），且未被.dockerignore排除。
• 在Dockerfile的dotnet build前添加验证步骤，查看文件是否存在：

  RUN ls -la wwwroot/js/
  

2. 修正bundleconfig.json格式问题 #

原配置中存在JSON语法冗余（对象末尾多余逗号），可能导致解析异常，修正后的配置：

[
  {
    "outputFileName": "wwwroot/js/site.min.js",
    "inputFiles": [
      "wwwroot/js/site.js"
    ],
    "minify": {
      "enabled": true,
      "renameLocals": true,
      "alwaysEscapeNonAscii": true,
      "gzip": false,
      "preserveImportantComments": false
    }
  }
]

3. 固定BuildBundlerMinifier版本并调整包引用方式 #

直接在Dockerfile中执行dotnet add package可能引入与.NET6不兼容的旧版本，建议在项目文件（View.Site.csproj）中明确指定兼容版本：

<ItemGroup>
  <PackageReference Include="BuildBundlerMinifier" Version="3.2.449" PrivateAssets="all" />
</ItemGroup>

随后移除Dockerfile中的RUN dotnet add package BuildBundlerMinifier步骤，依赖会通过dotnet restore自动安装。

4. 规范Docker构建的工作目录 #

确保构建时工作目录正确，避免路径解析错误，调整Dockerfile：

WORKDIR /src
COPY ["View.Site.csproj", "."]
RUN dotnet restore "./View.Site.csproj"
COPY . .
RUN dotnet build "View.Site.csproj" -c Release -o /app/build

5. 启用详细日志定位根因 #

执行构建时添加详细日志参数，获取更多错误细节：

RUN dotnet build "View.Site.csproj" -c Release -o /app/build -v detailed

通过详细日志可明确是文件路径、配置解析还是工具本身的问题。

内容的提问来源于stack exchange，提问作者Fatih Çelik