Cocos Creator V2.4.3导出安卓项目Gradle构建报:game配置空指针错误

数据老陈

2026-11-1

:game模块配置阶段NullPointerException排查方案

该报错是Cocos Creator V2.4.3导出Android工程后的高发配置期错误，绝大多数场景和SDK/NDK环境重装无关，可按以下优先级逐次排查：

1. 优先核对NDK路径与AGP的兼容问题

检查工程根目录local.properties文件内的ndk.dir配置项：确认指向的NDK 19.2.5345600路径真实存在，且路径中无中文、空格、特殊字符。Cocos导出的工程经常会自动生成嵌套错误路径（比如指向了NDK目录下多余的嵌套子文件夹），AGP读取不到NDK元信息时会直接在配置:game模块时触发无报错信息的空指针。
可以做个快速验证：把:game模块build.gradle内所有和NDK相关的配置暂时注释，重新跑一次配置流程，如果报错消失即可100%锁定是NDK配置触发的问题。
注意：AGP 3.2.0对r19版本NDK的路径识别存在已知bug，必须把ndk.dir指向包含source.properties文件的NDK根目录，不能指到上级或下级文件夹。

当前使用的AGP版本为3.2.0，官方适配的最高SDK Build Tool版本为28.0.3，强行使用30.0.3版本的Build Tool时，AGP在解析:game模块的编译参数时会触发未捕获的空指针，全程无具体错误栈输出。
调整方式：在:game模块的build.gradle中强制指定适配的Build Tool版本：

android {
    buildToolsVersion "28.0.3"
    // 其余原有配置保持不变
}

jcenter仓库目前已停止运维，Gradle 4.10.3拉取旧依赖时如果拿到空响应，在配置:game模块依赖时会直接触发空指针。需要把本地libs目录的flatDir仓库优先级提到最高，调整根目录build.gradle的allprojects配置块：

allprojects {
    repositories {
        flatDir {
                dirs 'libs'
        }
        google()
        jcenter()
    }
}

检查:game模块的libs目录完整性：确认Cocos导出的libcocos2dx.aar文件存在无缺失，模块加载本地依赖时读不到文件也会触发无提示的空指针。

哪怕重装了全套SDK环境，之前构建残留的损坏Gradle缓存依然会带着错误的解析结果，在配置阶段触发空指针：
- 执行命令停止所有Gradle守护进程：./gradlew --stop
- 删除工程根目录下的.gradle隐藏文件夹，以及所有模块路径下的build输出文件夹
- 先在命令行执行./gradlew :game:help触发干净的配置流程，验证报错是否复现，不要直接依赖Android Studio的自动同步。

不要把导出的安卓工程放在带中文、空格的路径下，Gradle解析带非ASCII字符的路径时会直接触发空指针，这也是很多人重装全套环境依然解决不了报错的核心原因。
确认Gradle实际使用的JDK版本：虽然安装的是jdk1.8.0_281，但如果系统默认用了高版本JDK11/17来跑Gradle，AGP 3.2.0在配置模块时会触发无信息的空指针。可以在工程根目录的gradle.properties里手动指定JDK路径：

org.gradle.java.home=本地jdk1.8.0_281的完整安装路径

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