ASP.NET Core 应用发布到 IIS 的常见问题及解决方案

基础概念

ASP.NET Core 是一个跨平台的、高性能的开源框架，用于构建现代云基础架构的 Web 应用和服务。IIS (Internet Information Services) 是 Windows 服务器上的 Web 服务器软件。

常见错误原因及解决方案

1. 缺少 ASP.NET Core 托管捆绑包

问题原因：IIS 需要 ASP.NET Core 模块才能托管 ASP.NET Core 应用，如果未安装会导致 502.5 错误。

解决方案：

• 下载并安装 .NET Core 托管捆绑包
• 确保安装的版本与你的应用匹配

2. 应用程序池配置不当

问题原因：ASP.NET Core 应用需要配置为无托管代码模式。

解决方案：

1. 打开 IIS 管理器
2. 选择应用程序池
3. 右键点击你的应用池 → 基本设置
4. 将 ".NET CLR 版本" 设置为 "无托管代码"

3. 权限问题

问题原因：IIS 应用池账户可能没有足够的权限访问应用文件夹。

解决方案：

1. 右键点击应用文件夹 → 属性 → 安全
2. 添加 IIS_IUSRS 用户组并授予读取和执行权限
3. 添加应用池使用的特定用户（如果使用自定义账户）

4. 发布配置错误

问题原因：发布时未选择正确的部署模式或目标运行时。

解决方案：

• 确保发布配置文件中包含以下设置：

<PropertyGroup>
  <TargetFramework>netcoreapp3.1</TargetFramework>
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  <PublishReadyToRun>true</PublishReadyToRun>
</PropertyGroup>

5. web.config 文件问题

问题原因：web.config 文件可能不正确或缺失。

解决方案：

• 确保 web.config 包含正确的 ASP.NET Core 模块配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

6. 端口冲突

问题原因：应用可能尝试使用已被占用的端口。

解决方案：

• 检查应用是否配置了特定端口
• 在 IIS 中更改绑定端口

7. 依赖项缺失

问题原因：服务器上缺少运行时或依赖项。

解决方案：

• 确保服务器安装了正确的 .NET Core 运行时
• 对于独立部署，确保发布时包含所有依赖项

调试技巧

1. 启用日志：
   • 修改 web.config 中的 stdoutLogEnabled="true"
   • 创建 logs 文件夹并设置适当权限

• 检查 Windows 事件日志：
  • 查看 Windows 事件查看器中的应用程序日志
• 使用进程资源管理器：
  • 检查 w3wp.exe 进程是否正常运行

最佳实践

1. 使用独立部署可减少服务器配置问题
2. 在开发和生产环境使用相同的 IIS 配置
3. 定期更新 .NET Core 运行时和托管捆绑包
4. 使用 HTTPS 和适当的身份验证配置

通过以上步骤，大多数 ASP.NET Core 应用发布到 IIS 的问题都能得到解决。如果问题仍然存在，建议检查具体的错误信息并针对性地搜索解决方案。