Flutter构建失败：notification_permissions编译错误解决

2025-03-05 05:14:21

Flutter 项目构建失败：notification_permissions:compileDebugJavaWithJavac 错误解决

碰上 :notification_permissions:compileDebugJavaWithJavac 编译失败？别慌，这问题挺常见，接下来就教你怎么一步步解决它。

一、问题：编译时 Java 报错

Flutter 项目在构建 Android 应用时，报了这么个错：

Execution failed for task ':notification_permissions:compileDebugJavaWithJavac'.
> Compilation failed; see the compiler error output for details.

从错误信息来看，问题出在 notification_permissions 这个插件的 Java 代码编译环节。具体哪里出错了, 错误日志会写（通常很长，得仔细找）。

这个错误通常由以下几个原因引起：

下面提供几种解决思路，一般从易到难，按顺序尝试：

有时，简单的清理和重建就能解决问题，就像电脑重启一样。

操作：

在项目根目录执行以下命令：

flutter clean
flutter pub get

然后重新构建。

flutter build apk # 或者 flutter run

确保你的 JDK 安装正确，且版本兼容。

操作：
1. 检查 JDK 是否安装：
```
java -version
javac -version
```
  确保这两个命令都能正常输出版本信息。
2. 确认Android Studio使用正确的JDK.
  
  打开 Android Studio, File > Project Structure > SDK Location。
  检查 "JDK location" 是否指向了正确的 JDK 安装路径。
  或者在项目的 android/local.properties 文件中,查看是否有类似sdk.dir 和jdk.dir配置(若无，可以尝试手动添加正确的JDK路径，并保存后重启IDE，再次尝试编译).
  
  示例 (local.properties):
```
sdk.dir=C:\\Users\\YourUser\\AppData\\Local\\Android\\Sdk
jdk.dir=C:\\Program Files\\Java\\jdk1.8.0_202
```
3. Flutter 项目设置（非必需，通常自动配置）：
  - 在项目根目录下的android/build.gradle文件中：
```
 // ...
  compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
   }
```
// ...
```
原理：
Java 代码需要 JDK 编译，Android Studio 构建也依赖 JDK。确保使用正确的 JDK 版本至关重要。

操作：
1. 查看 notification_permissions 插件的官方文档，确认其支持的 Flutter、Dart 和 Android SDK 版本。
2. 查看项目 pubspec.yaml 文件, 核对 notification_permissions 和其他相关插件的版本。如果用了比较新的版本，试试降级到更稳定的旧版本，或者看看有没有兼容性更好的替代插件。
```
dependencies:
  flutter:
    sdk: flutter
  notification_permissions: ^0.6.1  # 举例, 具体版本号可能不同.
  # ... 其他依赖
```
3. 如果使用了 dependency_overrides，暂时移除相关配置, 看是不是它们导致的冲突.
原理：

插件版本之间可能不兼容。确认使用相互兼容的版本，或者查看插件的 issue 列表,看是否有其他开发者遇到类似问题。

如果你修改过 Android 原生代码 (比如 android/app/src/main 下的文件), 检查这些代码是否有语法错误或逻辑问题。

操作：
- 使用Android Studio打开你Flutter项目下的android目录。
- Android Studio 会自动帮你检查原生代码(Java/Kotlin)是否存在问题。
  如果原生代码中引用了不存在的类、方法，或者存在编译错误,Android Studio都会给出提示, 并指明位置.
原理：

即使错误提示指向插件, 但问题也可能是你的代码间接引起的. 原生代码的错误会影响整个构建过程。

检查 android/build.gradle 和 android/app/build.gradle。

操作：
- 确认 compileSdkVersion、minSdkVersion、targetSdkVersion 设置是否合理, 以及是否与插件要求一致。
- 确保kotlin版本号不要过于激进,可以尝试降低Kotlin插件版本(对应修改android/build.gradle中的ext.kotlin_version).
  
  例如，将：
```
 buildscript {
   ext.kotlin_version = '1.9.0' // 或者其他版本号
```
  改为更稳定的版本：
```
    ext.kotlin_version = '1.7.20'
```
- 如果配置了multiDexEnabled true, 而且你的项目方法数较多, 尝试加大dexOptions中的javaMaxHeapSize。
  
  示例 (android/app/build.gradle) :
```
 defaultConfig {
       // ...
       multiDexEnabled true
  }
dexOptions {
  javaMaxHeapSize "4g" //或者更大, 根据你的机器配置
}
```
原理：

Gradle 负责 Android 项目的构建，配置错误也会导致编译问题.

如果以上方法都不奏效，需要查看更详细的构建日志。

操作：

在执行构建命令时，加上 --verbose 或 --debug 参数：
```
flutter build apk --verbose
# 或者
flutter run --debug
```
然后仔细阅读输出的日志，重点关注与 notification_permissions 和 Java 编译相关的错误信息。
原理：

详细日志会提供更多关于编译失败的信息, 帮助你定位问题的根本原因.

确保你的项目使用了 Gradle Wrapper,并且版本是较新的且较为稳定的.