在IIS容器部署ASP.NET Core 3.1应用出现500错误求助

一、补全基础镜像缺失的核心组件 #

mcr.microsoft.com/windows/servercore/iis仅包含基础IIS环境，未预装ASP.NET Core运行时和IIS模块，这是导致500错误的最常见原因：

• 在Dockerfile中添加ASP.NET Core 3.1托管包安装步骤（替换为对应版本的官方下载链接）：

  RUN powershell -Command \
      Invoke-WebRequest -Uri "https://download.visualstudio.microsoft.com/download/pr/19024444-9d6a-47a0-9306-010237a9c9a4/dotnet-hosting-3.1.30-win.exe" -OutFile dotnet-hosting.exe; \
      Start-Process -FilePath .\dotnet-hosting.exe -ArgumentList '/quiet /norestart' -Wait; \
      Remove-Item -Path dotnet-hosting.exe -Force
  

• 修正应用程序池设置：ASP.NET Core应用需使用无托管代码的应用程序池，修改默认池配置：

  RUN %windir%\system32\inetsrv\appcmd set apppool "DefaultAppPool" /managedRuntimeVersion:""
  

二、修正部署操作逻辑 #

• 优先清空wwwroot目录而非删除目录（避免权限或目录重建问题）：

  Remove-Item -Path C:\inetpub\wwwroot\* -Recurse -Force
  

• 完整复制发布文件：确保发布输出包含web.config、应用DLL、依赖文件及wwwroot静态资源目录，复制命令：

  Copy-Item -Path C:\path\to\published\app\* -Destination C:\inetpub\wwwroot\ -Recurse -Force
  

三、配置日志获取具体错误信息 #

• 开启应用stdout日志：修改web.config中的配置，启用后可查看应用级异常：

  <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  

  提前创建日志目录：

  New-Item -Path C:\inetpub\wwwroot\logs -ItemType Directory -Force
  

• 开启IIS详细错误页面：替换通用500提示为具体错误详情：

  %windir%\system32\inetsrv\appcmd set config "Default Web Site" /section:system.webServer/httpErrors /errorMode:Detailed
  

四、验证目录权限 #

• 确保应用程序池身份对wwwroot有读取执行权限（如需写入则添加对应权限）：

  icacls C:\inetpub\wwwroot /grant "IIS AppPool\DefaultAppPool:(OI)(CI)RX"
  

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