Android Studio报错：app debug:x86 无法配置C/C++

问题场景 #

全新Windows系统，首次使用Android Studio开发，无其他开发软件，最新版AS执行构建时出现:app debug:x86 failed to configure C/C++错误，日志抛出空指针异常：

:app debug:x86 failed to configure C/C++
null
java.lang.NullPointerException
    at com.android.build.gradle.tasks.CmakeServerExternalNativeJsonGenerator.getProcessBuilder(CmakeServerExternalNativeJsonGenerator.kt:90)
    at com.android.build.gradle.tasks.ExternalNativeJsonGenerator.configureOneAbi(ExternalNativeJsonGenerator.kt:148)
    at com.android.build.gradle.tasks.ExternalNativeJsonGenerator.configure(ExternalNativeJsonGenerator.kt:102)

.............

    at org.gradle.internal.concurrent.ManagedExecutorImpl$1.run(ManagedExecutorImpl.java:49)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635)
    at java.base/java.lang.Thread.run(Thread.java:833)

已尝试Invalidate cache无效，以下是可行解决方案：

解决方案 #

1. 校验CMake与NDK安装状态 #

• 打开Android Studio，进入File > Settings > Appearance & Behavior > System Settings > Android SDK > SDK Tools
• 勾选CMake和NDK (Side by side)，选择AS推荐的稳定版本（避免预览版），点击Apply完成安装
• 若已安装，点击Remove卸载后重新安装，排除安装包损坏问题

2. 配置CMake系统环境变量 #

• 找到CMake安装路径，通常为C:\Users\<你的用户名>\AppData\Local\Android\Sdk\cmake\<对应版本>\bin
• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的Path中添加上述路径
• 重启Android Studio和电脑，确保环境变量生效

3. 修正项目Gradle配置 #

• 项目级build.gradle：确认ndkVersion和cmakeVersion与安装版本一致

  android {
      ...
      ndkVersion "25.2.9519653" // 替换为你安装的NDK版本号
      externalNativeBuild {
          cmake {
              version "3.22.1" // 替换为你安装的CMake版本号
          }
      }
  }
  

• 模块级build.gradle：检查externalNativeBuild配置，确保CMakeLists路径正确，ABI过滤器包含x86

  android {
      ...
      defaultConfig {
          ...
          externalNativeBuild {
              cmake {
                  cppFlags ""
                  abiFilters "x86", "armeabi-v7a", "arm64-v8a", "x86_64"
              }
          }
      }
      externalNativeBuild {
          cmake {
              path "CMakeLists.txt" // 若文件在子目录，需写相对路径如"src/main/cpp/CMakeLists.txt"
              version "3.22.1"
          }
      }
  }
  

4. 清理并重新构建项目 #

• 点击AS工具栏Build > Clean Project，完成后点击Build > Rebuild Project
• 或使用终端执行命令：

  gradlew clean
  gradlew assembleDebug
  

5. 检查系统权限 #

• 右键Android Studio图标，选择「以管理员身份运行」，避免权限不足导致文件读写失败
• 不要将项目放在C盘Program Files等需要特殊权限的目录下，建议放在用户目录或D盘

内容的提问来源于stack exchange，提问作者Mohammed Abdelkrim Mekdour