Netflix DGS SpringBoot集成GraphiQL遇404资源未找到问题求助

以下是针对你遇到的"No static resource graphiql"错误的逐步排查和解决步骤：

1. 核对GraphiQL依赖配置 #

确保pom.xml中引入了正确的DGS GraphiQL starter依赖，不要用错artifactId：

<dependency>
    <groupId>com.netflix.graphql.dgs</groupId>
    <artifactId>netflix-dgs-graphiql-spring-boot-starter</artifactId>
    <version>你的DGS版本号</version>
</dependency>

注意版本要和你项目使用的DGS核心版本保持一致，比如DGS 5.x对应Spring Boot 2.7+，DGS 6.x对应Spring Boot 3.x。

2. 检查GraphiQL配置项 #

打开application.properties，确认配置没有拼写错误：

dgs.graphql.graphiql.enabled=true
dgs.graphql.graphiql.path=/graphiql

如果自定义了path，要访问对应路径，比如设为/graphiql-ui就访问http://localhost:8080/graphiql-ui。

3. 验证DGS自动配置是否被拦截 #

如果你项目里有自定义的WebMvcConfigurer或DispatcherServlet配置，可能会覆盖DGS的静态资源路由。此时需要手动放行GraphiQL的资源：

@Configuration
public class CustomWebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/graphiql/**")
                .addResourceLocations("classpath:/static/graphiql/");
    }
}

4. 确认schema文件位置是否正确 #

DGS默认扫描src/main/resources/schema下的schema.graphqls文件，如果你的schema放在其他目录，需要显式配置：

dgs.graphql.schema-locations=classpath:/你的自定义目录/*.graphqls

schema加载失败会导致DGS核心组件无法初始化，进而影响GraphiQL。

5. 查看启动日志定位初始化问题 #

启动应用时，检查日志中是否有DGS初始化的相关输出：

[main] INFO com.netflix.graphql.dgs.DgsAutoConfiguration - Initialized DGS Framework
[main] INFO com.netflix.graphql.dgs.GraphiQLAutoConfiguration - GraphiQL enabled at /graphiql

如果没有这些日志，说明DGS自动配置未生效，大概率是依赖冲突或Spring Boot版本不兼容。

6. 排查依赖冲突 #

执行mvn dependency:tree查看依赖树，检查是否有其他GraphQL相关依赖（比如spring-graphql）与DGS冲突。如果有，排除冲突依赖：

<dependency>
    <groupId>com.netflix.graphql.dgs</groupId>
    <artifactId>netflix-dgs-graphiql-spring-boot-starter</artifactId>
    <version>你的DGS版本号</version>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.graphql</groupId>
            <artifactId>spring-graphql</artifactId>
        </exclusion>
    </exclusions>
</dependency>

7. 先验证核心GraphQL端点 #

先测试默认的GraphQL端点/graphql是否可用：

curl -X POST -H "Content-Type: application/json" -d '{"query":"{你的查询字段}"}' http://localhost:8080/graphql

如果这个端点也返回404，说明DGS核心组件未初始化，检查主类是否添加了@EnableDgs注解（虽然starter默认自动配置，但部分场景需要显式添加）。

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