为ASP.NET MVC 4.6.1+Angular11添加Docker支持时遇路径及调试错误

问题现象 #

1. Docker构建时报错：Error: Value cannot be null Parameter name: path2
2. 忽略构建错误强制运行后，触发调试错误：

Unable to start debugging on the web server. Invalid URI: The hostname could not be parsed.

当前配置 #

Dockerfile #

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.6.2
ARG source
WORKDIR /inetpub/wwwroot

EXPOSE 80
EXPOSE 443

#install node js
RUN curl -sL https://deb.nodesource.com/setup_8.3.x |  bash -
RUN apt-get install -y nodejs

# copy csproj and restore as distinct layers
COPY ./*.csproj .

# copy everything else and build app
COPY . .
WORKDIR /build
RUN msbuild publish -c release -o published --no-cache

COPY ${source:-obj/Docker/publish} .

ENTRYPOINT ["dotnet", "MyWebApp.Web.dll"]

.csproj相关配置 #

<Target Name="NpmInstall" Inputs="$(ProjectDir)AA-Crew-LastLiveLeg-Web/package.json" Outputs="node_modules/.install-stamp">
  
    <Exec Command="npm ci" WorkingDirectory="$(ProjectDir)MyWebApp-Web" Condition="$(RestorePackagesWithLockFile) == 'true'" />
    <Exec Command="npm install" WorkingDirectory="$(ProjectDir)MyWebApp-Web" Condition="$(RestorePackagesWithLockFile) != 'true'" />
    <!-- Write the stamp file, so incremental builds work -->
    <!-- <Touch Files="node_modules/.install-stamp" AlwaysCreate="true" /> -->
  </Target>


  <Target Name="RemoveAngularOutput" BeforeTargets="BeforeBuild" Condition="'$(Configuration)' == 'Debug'">
    <RemoveDir Directories="$(ProjectDir)bundles" />
  </Target>
  <Target Name="NgDebug" DependsOnTargets="NpmInstall" BeforeTargets="BeforeBuild" Condition="'$(Configuration)' == 'Debug'">
    <Exec WorkingDirectory="$(ProjectDir)MyWebApp-Web" Command="npm run build" />
  </Target>
  <Target Name="NgRelease" DependsOnTargets="NpmInstall" BeforeTargets="BeforeBuild" Condition="'$(Configuration)' == 'Release'">
    <Exec WorkingDirectory="$(ProjectDir)MyWebApp-Web" Command="npm run build-prod" />
  </Target>

错误根源分析 #

Dockerfile核心问题 #

1. 镜像与命令不兼容：mcr.microsoft.com/dotnet/framework/aspnet:4.6.2是Windows容器镜像，却使用了curl、apt-get等Linux命令，直接导致Node.js安装失败，后续构建流程混乱。
2. 路径格式错误：Windows容器需使用Windows格式路径（如C:\inetpub\wwwroot），而非Linux风格的/inetpub/wwwroot。
3. 启动命令错误：ASP.NET MVC 4.6.1基于System.Web，依赖IIS托管，不需要dotnet命令启动，Windows容器会自动通过IIS运行站点。
4. MSBuild命令不规范：msbuild publish写法不符合要求，未指定项目文件，且构建输出路径未匹配Windows容器目录结构。
5. 工作目录逻辑混乱：先后设置/inetpub/wwwroot和/build两个工作目录，路径逻辑冲突。

.csproj配置问题 #

NpmInstall目标中，Inputs指定的$(ProjectDir)AA-Crew-LastLiveLeg-Web/package.json路径，与WorkingDirectory设置的$(ProjectDir)MyWebApp-Web不匹配，导致找不到package.json，触发path2为空的构建错误。

修复方案 #

1. 修正Dockerfile（适配Windows容器） #

# 使用匹配ASP.NET 4.6.1的Windows容器镜像
FROM mcr.microsoft.com/dotnet/framework/aspnet:4.6.1-windowsservercore-ltsc2019
ARG source

# 设置Windows格式工作目录
WORKDIR C:\inetpub\wwwroot

EXPOSE 80
EXPOSE 443

# 安装适配Angular 11的Windows版Node.js（14.x版本）
ADD https://nodejs.org/dist/v14.21.3/node-v14.21.3-x64.msi C:\temp\node.msi
RUN msiexec /i C:\temp\node.msi /qn ADDLOCAL=ALL
RUN del C:\temp\node.msi

# 复制项目文件到构建目录
COPY . C:\build
WORKDIR C:\build
# 执行MSBuild发布，指定项目文件、配置和输出目录
RUN msbuild MyWebApp.Web.csproj /p:Configuration=Release /p:DeployOnBuild=true /p:PublishProfile=FileSystem /p:PublishDir=C:\publish

# 将发布产物复制到IIS根目录
COPY C:\publish\* C:\inetpub\wwwroot\

# Windows容器无需自定义ENTRYPOINT，IIS自动启动

2. 修正.csproj路径匹配问题 #

将NpmInstall目标的Inputs路径与WorkingDirectory统一，同时补全增量构建的标记文件路径：

<Target Name="NpmInstall" Inputs="$(ProjectDir)MyWebApp-Web/package.json" Outputs="$(ProjectDir)MyWebApp-Web/node_modules/.install-stamp">
  
    <Exec Command="npm ci" WorkingDirectory="$(ProjectDir)MyWebApp-Web" Condition="$(RestorePackagesWithLockFile) == 'true'" />
    <Exec Command="npm install" WorkingDirectory="$(ProjectDir)MyWebApp-Web" Condition="$(RestorePackagesWithLockFile) != 'true'" />
    <Touch Files="$(ProjectDir)MyWebApp-Web/node_modules/.install-stamp" AlwaysCreate="true" />
  </Target>

3. 调试错误修复 #

修正Dockerfile后，容器会正常启动IIS站点，调试时需确保：

• Docker容器映射的端口与调试配置中的端口一致
• 通过docker inspect <container-id>获取容器IP，调试时指定该IP作为目标主机

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