升级2016年安卓旧项目后构建报java.lang.NullPointerException无错误信息

恢复2016年老旧安卓项目，完成Gradle插件、gradlew-wrapper、databinding导入规则及其他项目升级相关问题修复后，构建运行时被中断，抛出无详细信息的空指针错误：

java.lang.NullPointerException (no error message)

为构建指令添加--stacktrace参数后得到的堆栈信息如下，仅能看到Gradle内部异常，无业务相关错误提示：

java.lang.NullPointerException
    at org.gradle.internal.exceptions.DefaultMultiCauseException.printSingleCauseStackTrace(DefaultMultiCauseException.java:143)
    at org.gradle.internal.exceptions.DefaultMultiCauseException.printStackTrace(DefaultMultiCauseException.java:131)
    at org.gradle.internal.build.event.types.DefaultFailure.fromThrowable(DefaultFailure.java:56)
    at org.gradle.internal.build.event.types.DefaultFailure.fromThrowable(DefaultFailure.java:58)
    at org.gradle.internal.build.event.types.DefaultFailure.fromThrowable(DefaultFailure.java:58)
    at org.gradle.tooling.internal.provider.runner.ClientForwardingTaskOperationListener.toTaskResult(ClientForwardingTaskOperationListener.java:125)
    at org.gradle.tooling.internal.provider.runner.ClientForwardingTaskOperationListener.toFinishedEvent(ClientForwardingTaskOperationListener.java:91)
    at org.gradle.tooling.internal.provider.runner.ClientForwardingTaskOperationListener.toFinishedEvent(ClientForwardingTaskOperationListener.java:59)
    at org.gradle.tooling.internal.provider.runner.SubtreeFilteringBuildOperationListener.finished(SubtreeFilteringBuildOperationListener.java:96)
    at org.gradle.tooling.internal.provider.runner.SubtreeFilteringBuildOperationListener.finished(SubtreeFilteringBuildOperationListener.java:98)
    at org.gradle.tooling.internal.provider.runner.ClientForwardingProjectConfigurationOperationListener.finished(ClientForwardingProjectConfigurationOperationListener.java:73)
    at org.gradle.internal.operations.DefaultBuildOperationListenerManager$ProgressShieldingBuildOperationListener.finished(DefaultBuildOperationListenerManager.java:127)
    at org.gradle.internal.operations.DefaultBuildOperationListenerManager$1.finished(DefaultBuildOperationListenerManager.java:60)
    at org.gradle.internal.operations.DefaultBuildOperationExecutor$ListenerAdapter.stop(DefaultBuildOperationExecutor.java:170)
    at org.gradle.internal.operations.DefaultBuildOperationRunner$BuildOperationTrackingListener.stop(DefaultBuildOperationRunner.java:229)
    at org.gradle.internal.operations.DefaultBuildOperationRunner$3.execute(DefaultBuildOperationRunner.java:82)
    at org.gradle.internal.operations.DefaultBuildOperationRunner$3.execute(DefaultBuildOperationRunner.java:68)
    at org.gradle.internal.operations.DefaultBuildOperationRunner.execute(DefaultBuildOperationRunner.java:153)
    at org.gradle.internal.operations.DefaultBuildOperationRunner.execute(DefaultBuildOperationRunner.java:68)
    at org.gradle.internal.operations.DefaultBuildOperationRunner.call(DefaultBuildOperationRunner.java:62)
    at org.gradle.internal.operations.DefaultBuildOperationExecutor.lambda$call$2(DefaultBuildOperationExecutor.java:76)
    at org.gradle.internal.operations.UnmanagedBuildOperationWrapper.callWithUnmanagedSupport(UnmanagedBuildOperationWrapper.java:54)
    at org.gradle.internal.operations.DefaultBuildOperationExecutor.call(DefaultBuildOperationExecutor.java:76)
    at org.gradle.api.internal.tasks.execution.EventFiringTaskExecuter.execute(EventFiringTaskExecuter.java:52)
    at org.gradle.execution.plan.LocalTaskNodeExecutor.execute(LocalTaskNodeExecutor.java:41)
    at org.gradle.execution.taskgraph.DefaultTaskExecutionGraph$InvokeNodeExecutorsAction.execute(DefaultTaskExecutionGraph.java:372)
    at org.gradle.execution.taskgraph.DefaultTaskExecutionGraph$InvokeNodeExecutorsAction.execute(DefaultTaskExecutionGraph.java:359)
    at org.gradle.execution.taskgraph.DefaultTaskExecutionGraph$BuildOperationAwareExecutionAction.execute(DefaultTaskExecutionGraph.java:352)
    at org.gradle.execution.taskgraph.DefaultTaskExecutionGraph$BuildOperationAwareExecutionAction.execute(DefaultTaskExecutionGraph.java:338)
    at org.gradle.execution.plan.DefaultPlanExecutor$ExecutorWorker.lambda$run$0(DefaultPlanExecutor.java:127)
    at org.gradle.execution.plan.DefaultPlanExecutor$ExecutorWorker.execute(DefaultPlanExecutor.java:191)
    at org.gradle.execution.plan.DefaultPlanExecutor$ExecutorWorker.executeNextNode(DefaultPlanExecutor.java:182)
    at org.gradle.execution.plan.DefaultPlanExecutor$ExecutorWorker.run(DefaultPlanExecutor.java:124)
    at org.gradle.internal.concurrent.ExecutorPolicy$CatchAndRecordFailures.onExecute(ExecutorPolicy.java:64)
    at org.gradle.internal.concurrent.ManagedExecutorImpl$1.run(ManagedExecutorImpl.java:48)
    at org.gradle.internal.concurrent.ThreadFactoryImpl$ManagedThreadRunnable.run(ThreadFactoryImpl.java:56)

已尝试以下操作均无法解决问题：

• 删除项目内的.gradle目录
• 删除.idea目录
• 删除本机全局Android相关的.gradle/caches目录
• 执行上述操作后，再执行Invalidate Caches and Restart、重新导入项目、构建项目、同步项目、重启Android Studio

该空指针是Gradle Tooling转译原始构建异常时，内部处理逻辑异常导致的错误，并非真实的业务错误，需绕过Android Studio的Gradle封装层，直接获取原始构建日志：

• 在项目根目录打开终端，直接执行命令构建（不要通过Android Studio触发构建）：
  • macOS/Linux环境：./gradlew assembleDebug --stacktrace --info --no-daemon
  • Windows环境：gradlew.bat assembleDebug --stacktrace --info --no-daemon
• 命令执行后输出完整的构建日志，在空指针抛出前的最后30行日志中即可找到真实的业务错误信息。

Databinding兼容问题 #

90%以上的该类场景都是databinding语法和新版本AGP不兼容导致：

• 检查所有布局文件的<data>标签，删除无效的导入声明、修正和新版本关键字冲突的变量名
• 检查databinding表达式，旧版本支持的不规范空判断、泛型推导、资源引用写法在新版本AGP中会触发编译错误，优先校验升级过程中修改过的布局文件

AGP与Gradle版本错配 #

检查升级后的AGP版本和gradle-wrapper.properties中的Gradle版本是否严格匹配对应关系，版本错配会触发构建层无信息空指针，需按照官方要求调整为匹配的版本组合。

AAPT2资源编译兼容问题 #

旧项目的资源文件、第三方依赖aar的资源如果和AAPT2编译逻辑不兼容也会触发该错误，可在gradle.properties中临时添加android.enableAapt2=false禁用AAPT2后重新构建，若能正常输出错误信息，即可定位为资源兼容问题，对应升级冲突的第三方依赖或修改不兼容的资源写法即可。

构建脚本语法兼容问题 #

检查根目录build.gradle、模块build.gradle中的旧语法：

• 旧的compile依赖声明需替换为implementation/api
• 未完成AndroidX迁移的项目需检查support包和AndroidX包的冲突
• 删除旧版本AGP支持但新版本已废弃的配置项

内容的提问来源于stack exchange，提问作者P. Ilyin