.NET 8.0 Hosting Bundle在Windows Docker容器中生效失败及500报错排查

问题 #

我有一个基于Windows Docker镜像容器化的.NET 6.0 Web应用，此前运行正常。但迁移至.NET 8.0并修改Dockerfile对应配置后，应用始终抛出错误：HTTP Error 500.0 - ASP.NET Core IIS hosting failure (in-process)。不过将代码部署在Windows Server 2016的IIS上时运行正常。我的Dockerfile如下：

FROM mcr.microsoft.com/windows/servercore/iis AS final
SHELL ["powershell"]
EXPOSE 80 443

RUN Invoke-WebRequest 'https://download.visualstudio.microsoft.com/download/pr/7f4d5cbc-4449-4ea5-9578-c467821f251f/b9b19f89d0642bf78f4b612c6a741637/dotnet-runtime-8.0.0-win-x64.exe' -UserAgent '' -OutFile "C:/dotnet-runtime.exe"
RUN Start-Process -FilePath "c:/dotnet-runtime.exe" -ArgumentList @('/install', '/q', '/norestart', 'OPT_NO_RUNTIME=1', 'OPT_NO_SHAREDFX=1') -Wait -PassThru

RUN Invoke-WebRequest 'https://download.visualstudio.microsoft.com/download/pr/2a7ae819-fbc4-4611-a1ba-f3b072d4ea25/32f3b931550f7b315d9827d564202eeb/dotnet-hosting-8.0.0-win.exe' -UserAgent '' -OutFile "C:/dotnet-hosting.exe"
RUN Start-Process -FilePath "c:/dotnet-hosting.exe" -ArgumentList @('/install', '/q', '/norestart', 'OPT_NO_RUNTIME=1', 'OPT_NO_SHAREDFX=1') -Wait -PassThru

# Copy the build artifacts
ADD MyApp /inetpub/wwwroot

请问我的.NET 8 Hosting Bundle安装存在什么问题？此前.NET 6环境下运行正常，.NET 8的Hosting Bundle是否存在破坏性变更？（目前未找到相关信息）

分析与解决 #

你的Dockerfile中Hosting Bundle的安装参数存在核心问题，具体原因和修复方式如下：

1. 错误参数导致运行环境缺失 #

你在安装.NET Runtime和Hosting Bundle时添加的OPT_NO_RUNTIME=1、OPT_NO_SHAREDFX=1参数完全阻断了核心组件的安装：

• OPT_NO_RUNTIME=1：跳过.NET Runtime的安装流程
• OPT_NO_SHAREDFX=1：跳过.NET共享框架的安装

.NET 6对这类参数的校验较宽松，可能仍能保留部分必要组件，但.NET 8的Hosting Bundle对依赖检测更严格，缺少Runtime和共享框架会直接导致IIS无法托管ASP.NET Core应用，触发500错误。

2. 修复后的Dockerfile配置 #

移除错误参数，只保留静默安装的必要参数即可：

RUN Invoke-WebRequest 'https://download.visualstudio.microsoft.com/download/pr/7f4d5cbc-4449-4ea5-9578-c467821f251f/b9b19f89d0642bf78f4b612c6a741637/dotnet-runtime-8.0.0-win-x64.exe' -UserAgent '' -OutFile "C:/dotnet-runtime.exe"
RUN Start-Process -FilePath "c:/dotnet-runtime.exe" -ArgumentList @('/install', '/q', '/norestart') -Wait -PassThru

RUN Invoke-WebRequest 'https://download.visualstudio.microsoft.com/download/pr/2a7ae819-fbc4-4611-a1ba-f3b072d4ea25/32f3b931550f7b315d9827d564202eeb/dotnet-hosting-8.0.0-win.exe' -UserAgent '' -OutFile "C:/dotnet-hosting.exe"
RUN Start-Process -FilePath "c:/dotnet-hosting.exe" -ArgumentList @('/install', '/q', '/norestart') -Wait -PassThru

3. 额外优化建议 #

• 优先使用官方.NET基础镜像（如mcr.microsoft.com/dotnet/aspnet:8.0-nanoserver-ltsc2019），这类镜像已预装完整运行环境和Hosting组件，无需手动下载安装，避免参数配置错误
• 安装完成后可通过dotnet --info命令验证容器内的.NET环境是否正常部署

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