.NET 8中REST+GraphQL API部署IIS子目录后请求路径异常

1. 自动适配IIS虚拟路径，避免硬编码PathBase #

把硬写的app.UsePathBase("/Security/api")替换为自动读取IIS环境变量的逻辑，ASP.NET Core部署到IIS时会自动设置ASPNETCORE_PATHBASE变量，对应虚拟目录路径：

var pathBase = Environment.GetEnvironmentVariable("ASPNETCORE_PATHBASE") ?? "/Security";
app.UsePathBase(pathBase);

这样不管部署到哪个子目录，应用都会自动适配，无需手动修改代码。

2. 给Swagger规范添加正确的服务器地址 #

NSwag生成的Swagger UI请求URL缺失子目录，是因为OpenApi规范里未包含对应服务器地址。在配置OpenApi文档时补充Server配置：

services.AddOpenApiDocument(doc =>
{
    doc.AddServer(new OpenApiServer { Url = "/Security" });
});

同时调整Swagger UI的配置，确保它基于该服务器地址生成请求：

app.UseSwaggerUi(settings =>
{
    settings.DocumentPath = "/swagger/v1/swagger.json";
    settings.ApiBasePath = "/Security";
});

3. 修正HotChocolate UI的Schema请求路径 #

Banana Cake Pop加载Schema失败，是因为它默认使用根路径请求。配置GraphQL时指定Tool的服务器地址：

app.MapGraphQL("/graphql")
   .WithOptions(opt =>
   {
       opt.Tool = new GraphQLToolOptions
       {
           ServerAddress = "/Security/graphql"
       };
   });

这样UI就会用/Security/graphql路径请求Schema，而非直接使用/graphql。

4. 检查IIS虚拟目录基础配置 #

• 确认应用程序池选用.NET 8.0版本，不要误选.NET Framework类型的池
• 虚拟目录的“物理路径”指向API发布后的文件夹，给IIS_IUSRS组配置读取权限
• 确保IIS已安装URL重写模块，ASP.NET Core托管模块正常运行

5. 验证端点分组的路径逻辑 #

你的REST API分组在Postman中正常，说明分组逻辑没问题，但可以添加调试接口确认PathBase是否正确识别：

app.MapGet("/check-path", (HttpContext ctx) => 
    $"PathBase: {ctx.Request.PathBase}, Path: {ctx.Request.Path}");

部署后访问localhost/Security/check-path，若输出的PathBase为/Security，则说明路径基已正确加载。

内容的提问来源于stack exchange，提问作者Sergio Hernández