Capacitor升级至v6+Gradle v8.7后出现Namespace未指定错误

问题背景 #

升级Capacitor至v6、Gradle至8.7后，持续出现以下构建报错：

Namespace not specified. Specify a namespace in the module's build file:/node_modules/@capacitor/android/capacitor/build.gradle. 可参考Android官方关于设置namespace的说明。

如果你已在源AndroidManifest.xml中指定package属性，可以使用AGP升级助手迁移到构建文件中的namespace值。可参考AGP升级助手的通用使用说明。

已执行的排查操作：

• 使用Android Upgrade Assistant修改app及android目录下的build.gradle文件
• 在app/build.gradle中显式添加namespace，并确认AndroidManifest.xml的package声明无误
• 删除package-lock.json、node_modules及android文件夹后重新安装所有依赖
• 确认node_modules/@capacitor/android/capacitor/build.gradle中已正确配置namespace，但问题仍未解决

可行解决方案 #

1. 强制覆盖Capacitor模块的namespace配置 #

在项目根目录的android/build.gradle文件中添加以下配置，强制为Capacitor的android模块指定namespace：

subprojects {
    if (project.name == 'capacitor') {
        android {
            namespace "com.getcapacitor"
        }
    }
}

该配置会在构建阶段强制覆盖node_modules中Capacitor模块的namespace设置，确保AGP能正确识别。

2. 排查第三方插件兼容性 #

部分第三方Capacitor插件可能未适配AGP 8.x的namespace要求，间接引发报错：

• 升级所有第三方插件至支持Capacitor v6及AGP 8.x的最新版本
• 暂时禁用非核心插件，逐步排查是否为某一插件导致的冲突

3. 手动同步并清理构建缓存 #

通过Android Studio执行以下操作：

• 点击File > Sync Project with Gradle Files同步Gradle配置
• 执行Build > Clean Project后再执行Build > Rebuild Project
• 清理IDE缓存：File > Invalidate Caches... > Invalidate and Restart

说明 #

AGP 8.x要求所有Android模块必须在build.gradle中显式声明namespace，Capacitor v6部分版本的构建脚本可能存在兼容性问题，导致自动生成的namespace未被AGP正确识别。上述方案可直接修正模块的namespace配置，解决构建报错。

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