部署在IIS虚拟目录的EntityGraphQL端点无法运行问题

一、400错误的核心配置问题 #

IIS虚拟目录下，ASP.NET路由必须适配虚拟目录的路径前缀，硬写绝对路径或忽略PathBase会导致路由不匹配，直接返回400错误。你的配置中存在以下问题：

• 直接使用绝对路径/services/service/graphql，未考虑虚拟目录本身的路径前缀
• 未配置UsePathBase来对齐IIS虚拟目录的路径

修正配置方案 #

// 先配置PathBase，适配IIS虚拟目录的路径前缀
app.UsePathBase("/services/service");

app.UseEndpoints(routeBuilder =>
{
    routeBuilder.MapControllers();

    // 直接映射到相对根路径，PathBase会自动拼接虚拟目录前缀
    routeBuilder.MapGraphQL<Db>();

    // Altair的GraphQLEndPoint使用相对路径
    routeBuilder.MapGraphQLAltair(new AltairOptions
    {
        GraphQLEndPoint = "/graphql",
        // 关键：禁用CDN依赖，使用本地嵌入资源（解决无外网问题）
        UseEmbeddedResources = true
    });
});

额外IIS配置检查 #

• 确保虚拟目录的应用程序池使用**.NET 6.0**版本（或对应托管模式）
• 确认IIS已安装ASP.NET Core Module V2
• 检查web.config的aspNetCore节点配置，确保processPath指向dotnet.exe，arguments指向你的项目dll

二、无外网访问对CDN资源的影响 #

服务器无外网不会导致GraphQL接口本身返回400错误，但会影响Altair IDE的加载：

• 默认情况下，Altair会从CDN加载React、样式表等依赖资源，无外网时这些资源无法获取，IDE页面会空白或功能异常
• 但GraphQL接口本身如果配置正确，用Postman等工具直接发送POST请求（携带合法GraphQL查询体）应该能正常响应

解决CDN依赖问题 #

通过UseEmbeddedResources = true配置，让Altair使用EntityGraphQL包中嵌入的本地静态资源，完全不需要外网访问，如上面的修正代码所示。

排查辅助步骤 #

1. 用Postman直接调用http://server/services/service/graphql，发送POST请求（Content-Type: application/json），携带查询体如：

   {"query": "{ __typename }"}
   

   验证接口是否正常响应
2. 开启ASP.NET stdout日志：在web.config中设置stdoutLogEnabled="true"，查看日志文件获取400错误的具体原因（如路由匹配失败、请求格式错误等）

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