Apollo从3.8.2升级到4.0.0时提示找不到schema.graphqls文件

核心问题分析 #

Apollo 4.x对schema文件的配置逻辑做了调整，即便文件存在，也可能因路径配置、文件识别规则变化导致构建时无法找到。

具体排查步骤 #

• 检查gradle配置中的schema路径
  Apollo 4.x需要在build.gradle（或build.gradle.kts）中明确指定schema文件的位置，旧版本可能依赖默认路径，新版本必须显式配置。示例配置：

  android {
    // ...其他配置
    apollo {
      service("myService") {
        schemaFile.set(file("src/main/graphql/com/example/schema.graphqls"))
      }
    }
  }
  

  确保路径与实际文件位置完全匹配，注意大小写（尤其是在Linux/macOS环境下）。

• 确认schema文件的命名与格式
  检查.graphqls文件内容是否符合GraphQL SDL规范，比如是否存在语法错误。可以用GraphQL官方工具验证文件有效性，避免因文件损坏导致Apollo无法识别。

• 清理构建缓存并重新同步
  旧版本的构建缓存可能干扰新版本的识别逻辑，执行以下操作：

  • 点击Android Studio的File > Invalidate Caches...并重启IDE
  • 执行终端命令：./gradlew clean build --no-build-cache

• 检查模块依赖与插件版本
  确保所有依赖的Apollo插件和库版本一致，避免混合使用3.x和4.x的组件。比如apollo-gradle-plugin版本必须与apollo-runtime等库版本保持同步为4.0.0。

• 验证schema文件的资源目录配置
  确认schema文件所在的目录被标记为GraphQL Source Directory：右键目录 > Mark Directory as > GraphQL Source Root，确保Apollo插件能扫描到该目录下的schema文件。

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