添加Area后无法连接IIS Express/HTTPS，页面无法访问

问题描述 #

用Visual Studio 7.0开发ASP.NET Core站点，没加Area时能通过IIS正常访问默认页面；加Area后页面打不开。添加Area时只在Program.cs里加了端点路由，没改launchsettings.json。试过改localhost端口、删.vs目录里的配置文件，问题还是没解决。

原Program.cs代码 #

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();

builder.Services.AddMvc();

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, 
    see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.RunAsync();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
    name: "areas",
    pattern: "{area:exists}/{controller=Home}/{action=Index}/{id?}"
);
});

原launchsettings.json代码 #

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:16264",
      "sslPort": 44309
    }
  },
  "profiles": {
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "http://localhost:5053",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:7005;http://localhost:5053",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

问题根源 #

1. 中间件顺序错了：app.RunAsync()会直接终止请求管道，后面的app.UseEndpoints()根本不会执行，等于Area的路由规则根本没注册上。
2. 服务配置冗余：同时调用AddMvc()和AddRazorPages()，混合使用时容易出现配置冲突，应该统一配置。
3. Area路由覆盖不全：只配了Area存在时的路由，没确保根路径等默认访问场景的路由正常映射。

修复方案 #

1. 修正Program.cs的中间件和服务配置 #

把app.RunAsync()移到所有中间件配置最后，同时调整服务注册逻辑：

var builder = WebApplication.CreateBuilder(args);

// 注册HttpContextAccessor
builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();

// 统一注册支持Area的Razor Pages和MVC服务
builder.Services.AddRazorPages()
    .AddMvcOptions(options =>
    {
        // 给你的Area添加路由约定，替换成实际Area名称
        options.Conventions.AddAreaPageRoute("YourAreaName", "/", "");
    });

var app = builder.Build();

// 配置HTTP请求管道
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

// 先注册Area路由，再注册普通Razor Pages路由
app.MapControllerRoute(
    name: "areas",
    pattern: "{area:exists}/{controller=Home}/{action=Index}/{id?}"
);

app.MapRazorPages();

// 最后启动应用
app.Run();

2. 检查Area目录结构 #

确保Area符合标准结构，比如：

Areas/
├─ 你的Area名称/
│  ├─ Pages/
│  │  ├─ Home/
│  │  │  ├─ Index.cshtml
│  │  ├─ _ViewStart.cshtml
│  │  ├─ _ViewImports.cshtml
│  ├─ Controllers/
│  │  ├─ HomeController.cs

3. 额外排查步骤 #

• 看浏览器控制台的网络请求状态，确认是404还是服务器错误；
• 查看Visual Studio输出窗口，有没有路由注册失败或异常信息；
• 清理解决方案后重新生成，确保编译文件更新；
• 用dotnet run命令直接启动项目，排除IIS Express的配置问题。

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