在IIS上部署Angular与ASP.NET Core 8模板项目，Angular页面无法加载

一、部署配置检查与修复 #

1. 确认ASP.NET Core中间件顺序与SPA配置 #

打开Program.cs，确保静态文件和SPA中间件的配置正确且顺序无误：

// 启用静态文件服务
app.UseStaticFiles();
// 启用Angular静态文件服务（模板默认指向client项目的dist目录）
app.UseSpaStaticFiles();

app.UseRouting();

// 先处理API路由，避免被SPA规则拦截
app.MapControllers();

// SPA路由回退配置，必须放在API路由之后
app.UseSpa(spa =>
{
    // SourcePath对应你的client项目路径，模板默认可能是"ClientApp"或你的project.client名称
    spa.Options.SourcePath = "project.client";

    // 生产环境直接使用已构建的静态文件，无需启动Angular开发服务器
    if (!app.Environment.IsDevelopment())
    {
        spa.Options.DefaultPage = "/index.html";
    }
});

关键注意：UseSpa必须在MapControllers之后，确保API请求优先被处理，非API请求自动回退到Angular的index.html。

2. 发布配置验证 #

在Visual Studio发布server项目时：

• 进入发布配置的文件发布选项，确认勾选「在发布前生成客户端项目」，该选项会自动构建Angular项目并将dist文件复制到server项目的wwwroot目录下。
• 发布完成后，检查输出目录的wwwroot文件夹，确认包含index.html、main.js、styles.css等Angular构建产物。

3. IIS站点配置调整 #

• 安装依赖：确保服务器已安装ASP.NET Core 8.0 Runtime Hosting Bundle，否则IIS无法托管ASP.NET Core应用。
• 应用池设置：
  • .NET CLR版本选择「无托管代码」
  • 托管管道模式设置为「集成」
• 物理路径：站点物理路径指向发布后的server项目根目录（而非wwwroot）。
• 默认文档：在IIS站点的「默认文档」中，确保index.html存在且优先级最高。
• URL重写规则：检查发布目录下的web.config，确认包含SPA路由重写规则（模板默认会自动生成）：

<rewrite>
  <rules>
    <rule name="SPA Fallback" stopProcessing="true">
      <match url=".*" />
      <conditions>
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
        <add input="{REQUEST_URI}" pattern="^/(api)" negate="true" />
      </conditions>
      <action type="Rewrite" url="/index.html" />
    </rule>
  </rules>
</rewrite>

如果没有该规则，手动添加到web.config的system.webServer节点下。

二、调试与日志排查方法 #

1. 启用IIS站点日志 #

• 打开IIS管理器，选中目标站点→右键「属性」→「日志」，勾选「启用日志记录」，选择W3C格式并设置日志存储路径（默认在C:\inetpub\logs\LogFiles）。
• 访问根URL后，查看日志文件，可获取请求的状态码、请求路径、服务器响应细节，定位404的触发原因。

2. 查看ASP.NET Core stdout日志 #

• 打开发布目录下的web.config，找到aspNetCore节点，修改配置：

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

• 在发布目录下创建logs文件夹，访问根URL后，打开stdout日志文件，可查看ASP.NET Core处理请求的完整流程，包括静态文件查找、中间件执行情况等。

3. 本地Kestrel测试 #

在服务器上打开命令行，进入发布目录，执行：

dotnet project.server.dll

直接通过Kestrel服务器访问https://localhost:5001（或配置的HTTPS端口），若能正常加载Angular页面，说明问题出在IIS配置；若仍出现404，说明发布的静态文件缺失或ASP.NET Core配置错误。

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