如何配置Spring GraphQL以加载多个.graphqls schema文件？

核心问题分析 #

你之前的配置错误在于**spring.graphql.schema.locations属性接受的是目录路径，而非文件路径通配符**。你写的classpath*:schema/**/*.graphqls是文件匹配规则，但Spring会将其视为一个目录去查找，导致找不到有效目录，进而加载Schema失败，触发应用启动异常（白标页面就是启动失败的表现）。

正确配置方式 #

方式1：扫描根目录（推荐，适配未来新增Schema） #

直接指定Schema的根目录，Spring会自动递归扫描该目录下所有子文件夹中的.graphqls文件：

spring.graphql.schema.locations=classpath*:schema/

方式2：指定多个子目录 #

如果需要明确指定要加载的目录（不推荐，新增Schema需修改配置）：

spring.graphql.schema.locations=classpath*:schema/book/,classpath*:schema/infra/

额外排查点 #

• 确认Schema文件位置：确保所有.graphqls文件都放在项目的src/main/resources/schema/目录下（Maven/Gradle项目），这样打包后才会被纳入Classpath。
• 检查Schema语法：白标页面也可能是Schema文件本身存在语法错误（比如重复类型定义、字段类型不匹配等），启动时查看日志中的异常信息，定位具体的Schema问题。

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