ASP.NET Core与Vue.js同域名下SAML认证重定向问题求助

问题本质 #

同域名端口部署时，IIS会将所有请求（包括Vue前端路由）转发给ASP.NET Core后端，而前端路由并非后端API端点，因此返回404。核心是要让IIS/后端区分API请求与SPA路由请求，将非API请求转发到Vue的index.html。

1. 配置ASP.NET Core SPA Fallback路由 #

在后端的Program.cs中，按顺序注册中间件，先处理API请求，再添加SPA fallback规则，让后端无法匹配的请求重定向到Vue静态文件入口：

var builder = WebApplication.CreateBuilder(args);

// 注册服务
builder.Services.AddControllers();
builder.Services.AddSpaStaticFiles(config =>
{
    config.RootPath = "wwwroot"; // Vue打包文件存放目录
});

var app = builder.Build();

// 中间件顺序不可颠倒
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseSpaStaticFiles();

app.UseRouting();

// 配置API端点
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

// SPA fallback：所有非API请求转发到index.html
app.UseSpa(spa =>
{
    spa.Options.DefaultPage = "/index.html";
});

确保Vue打包后的dist目录内容已复制到后端的wwwroot文件夹中。

2. 配置IIS URL重写规则 #

如果ASP.NET Core fallback未生效（IIS直接拦截请求），在web.config中添加重写规则，排除API路径并转发其他请求到index.html：

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <!-- 放行API前缀的请求（根据你的实际API前缀调整） -->
        <rule name="Skip API Requests" stopProcessing="true">
          <match url="^api/(.*)" />
          <action type="None" />
        </rule>
        <!-- 转发非文件/目录的请求到index.html -->
        <rule name="SPA Fallback Route" stopProcessing="true">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="/index.html" />
        </rule>
      </rules>
    </rewrite>
    <aspNetCore processPath="dotnet" arguments=".\YourApi.dll" hostingModel="inProcess" />
  </system.webServer>
</configuration>

3. 调整Vue打包配置 #

在vue.config.js中设置publicPath为根路径，确保静态资源加载正常：

module.exports = {
  publicPath: '/',
  outputDir: '../YourApiProject/wwwroot' // 可选：直接打包到后端wwwroot目录
}

4. 验证SAML重定向路径 #

后端处理完SAML断言后，重定向的URL应为Vue前端路由（如/dashboard），而非全域名路径。确保该路由已在Vue中定义，这样请求转发到index.html后，Vue路由会正确渲染对应页面。

5. 检查IIS托管权限 #

确保IIS应用池用户对wwwroot目录有读取权限，避免静态文件无法加载。

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