ASP.NET Core 8.0 Web API部署IIS：从404到500错误求助

核心500错误解决（无法加载.NET 8运行时） #

• 问题根因：服务器仅安装了.NET Core 3.1.19和5.0.10运行时，缺少.NET 8.0.0版本的ASP.NET Core Runtime，导致IIS无法启动.NET 8应用。
• 处理步骤：
  1. 下载对应服务器系统架构的.NET 8.0 ASP.NET Core Runtime（x86/x64/ARM按需选择），完成安装。
  2. 重启IIS站点或对应的应用程序池，确保新安装的运行时被加载。

Swagger schemaId重复问题处理 #

之前出现SwaggerGeneratorException提示schemaId重复，导致Swagger生成失败，这也是初期404的诱因之一。解决方法是在Program.cs中自定义schemaId生成规则：

builder.Services.AddSwaggerGen(options =>
{
    // 用类型的完整命名空间+类名作为schemaId，避免同名冲突
    options.CustomSchemaIds(type => type.FullName);
});

日志目录权限问题修复 #

错误日志提示日志目录创建权限被拒绝，需给IIS应用程序池身份分配读写权限：

• 找到项目配置的日志目录（或发布后的默认日志路径）。
• 右键目录→属性→安全→编辑→添加，输入IIS AppPool\你的站点应用池名称，勾选读取和写入权限，保存设置。

初期404问题回顾排查 #

部署后首次出现404，除了Swagger生成失败的原因，还需确认：

• IIS站点物理路径是否指向正确的发布文件夹，且文件夹权限配置正常。
• 应用程序池的.NET CLR版本需设置为无托管代码（ASP.NET Core应用不需要传统托管CLR）。
• 站点绑定的域名、端口与请求一致，无防火墙或路由拦截。

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