升级旧Flutter项目后出现BuildConfig符号找不到错误求助

问题详情 #

升级两年前的Flutter项目后，调试时出现BuildConfig找不到的错误，已尝试谷歌和Stack Overflow上的方案一周仍未解决。

报错信息 #

Launching lib/main.dart on sdk gphone x86 in debug mode...
/Users/michael/.pub-cache/hosted/pub.dev/firebase_core-2.24.2/android/src/main/java/io/flutter/plugins/firebase/core/FlutterFirebaseCoreRegistrar.java:19:
error: cannot find symbol
LibraryVersionComponent.create(BuildConfig.LIBRARY_NAME, BuildConfig.LIBRARY_VERSION));
^
symbol: variable BuildConfig
location: class FlutterFirebaseCoreRegistrar

环境信息 #

[✓] Flutter (Channel stable, 3.16.1, on macOS 14.1.1 23B81 darwin-x64, locale de-DE)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.0.1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2022.3)
[✓] VS Code (version 1.84.2)
[✓] VS Code (version 1.48.2)

已尝试无效操作 #

• 修改firebase_core等插件的compileOptions为Java 17
• 切换Gradle版本至7.5或8.x
• 在app模块中开启buildFeatures.buildConfig=true

解决方案 #

1. 删除全局强制设置namespace的代码 #

根build.gradle中这段代码是问题核心——它强制所有子模块（包括第三方插件）使用你的app的namespace，破坏了插件自身的BuildConfig生成逻辑：

subprojects{
    afterEvaluate {
        android {
            namespace 'com.example.camflo'
        }
    }
}

直接删除这段代码即可。

2. 统一app模块的namespace和applicationId（可选） #

你的app模块中namespace和applicationId不一致，建议统一以避免潜在问题：

android {
    namespace "com.camflo.app" // 改为和applicationId一致
    defaultConfig {
        applicationId "com.camflo.app"
        // ...其他配置
    }
}

3. 彻底清理并重新构建 #

执行以下命令清理缓存并重建：

flutter clean
flutter pub cache repair
flutter pub get
cd android && ./gradlew clean && cd ..
flutter run

4. 移除冲突的native依赖 #

app模块build.gradle中手动添加的com.google.firebase:firebase-analytics:17.5.0和flutter端的firebase_analytics: ^10.7.1版本冲突，直接移除：

// 删除这一行
implementation 'com.google.firebase:firebase-analytics:17.5.0'

额外提示 #

• 不要修改pub缓存里的插件配置，修改后会被flutter pub get覆盖，还容易引发兼容性问题
• 升级旧项目时，建议先把Flutter SDK升到稳定版，再逐个升级依赖包，避免跨版本过大导致的各种冲突

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