创建Flutter项目编译崩溃，Dart编译器意外退出求助

问题背景 #

• flutter doctor检测结果完全正常
• 执行Running Gradle task 'assembleDebug'时触发Dart编译器意外退出
• 已尝试重装Android Studio、StackOverflow相关方案，均无效

编译错误日志 #

Launching lib\main.dart on Android SDK built for x86 in debug mode...
Running Gradle task 'assembleDebug'...
Unhandled exception:
Crash when compiling null,
at character offset null:
Unsupported operation: _ExplicitNamedTypeBuilder.registerInferredType
#0      TypeBuilder.registerInferredType (package:front_end/src/fasta/builder/type_builder.dart:350:5)
#1      DeclaredSourceConstructorBuilder.finalizeSuperInitializingFormals.performRecoveryForErroneousCase (package:front_end/src/fasta/source/source_constructor_builder.dart:355:23)
#2      DeclaredSourceConstructorBuilder.finalizeSuperInitializingFormals (package:front_end/src/fasta/source/source_constructor_builder.dart:375:14)
#3      DeclaredSourceConstructorBuilder.inferFormalTypes (package:front_end/src/fasta/source/source_constructor_builder.dart:290:9)
#4      DeclaredSourceConstructorBuilder.inferTypes (package:front_end/src/fasta/source/source_constructor_builder.dart:263:5)
#5      InferableTypeBuilder.inferType (package:front_end/src/fasta/builder/omitted_type_builder.dart:149:19)
#6      SourceLoader.performTopLevelInference (package:front_end/src/fasta/source/source_loader.dart:2358:19)
#7      KernelTarget.buildOutlines.<anonymous closure> (package:front_end/src/fasta/kernel/kernel_target.dart:532:14)
<asynchronous suspension>
#8      withCrashReporting (package:front_end/src/fasta/crash.dart:122:12)
<asynchronous suspension>
#9      IncrementalCompiler.computeDelta.<anonymous closure> (package:front_end/src/fasta/incremental_compiler.dart:407:33)
<asynchronous suspension>
#10     IncrementalCompiler.compile (package:vm/incremental_compiler.dart:68:50)
<asynchronous suspension>
#11     FrontendCompiler.compile (package:frontend_server/frontend_server.dart:572:11)
<asynchronous suspension>
#12     listenAndCompile.<anonymous closure> (package:frontend_server/frontend_server.dart:1210:11)
<asynchronous suspension>


#0      TypeBuilder.registerInferredType (package:front_end/src/fasta/builder/type_builder.dart:350:5)
#1      DeclaredSourceConstructorBuilder.finalizeSuperInitializingFormals.performRecoveryForErroneousCase (package:front_end/src/fasta/source/source_constructor_builder.dart:355:23)
#2      DeclaredSourceConstructorBuilder.finalizeSuperInitializingFormals (package:front_end/src/fasta/source/source_constructor_builder.dart:375:14)
#3      DeclaredSourceConstructorBuilder.inferFormalTypes (package:front_end/src/fasta/source/source_constructor_builder.dart:290:9)
#4      DeclaredSourceConstructorBuilder.inferTypes (package:front_end/src/fasta/source/source_constructor_builder.dart:263:5)
#5      InferableTypeBuilder.inferType (package:front_end/src/fasta/builder/omitted_type_builder.dart:149:19)
#6      SourceLoader.performTopLevelInference (package:front_end/src/fasta/source/source_loader.dart:2358:19)
#7      KernelTarget.buildOutlines.<anonymous closure> (package:front_end/src/fasta/kernel/kernel_target.dart:532:14)
<asynchronous suspension>
#8      withCrashReporting (package:front_end/src/fasta/crash.dart:122:12)
<asynchronous suspension>
#9      IncrementalCompiler.computeDelta.<anonymous closure> (package:front_end/src/fasta/incremental_compiler.dart:407:33)
<asynchronous suspension>
#10     IncrementalCompiler.compile (package:vm/incremental_compiler.dart:68:50)
<asynchronous suspension>
#11     FrontendCompiler.compile (package:frontend_server/frontend_server.dart:572:11)
<asynchronous suspension>
#12     listenAndCompile.<anonymous closure> (package:frontend_server/frontend_server.dart:1210:11)
<asynchronous suspension>
the Dart compiler exited unexpectedly.
the Dart compiler exited unexpectedly.

解决方案尝试 #

1. 清理Flutter和项目缓存 #

执行以下命令彻底清理缓存：

flutter clean
flutter pub get
rm -rf ~/.pub-cache  # macOS/Linux环境
# Windows环境执行：
rd /s /q %USERPROFILE%\.pub-cache

2. 切换到Flutter稳定版并更新 #

该错误多与Dart前端编译器版本兼容有关，切换到稳定版可解决大部分版本冲突问题：

flutter channel stable
flutter upgrade

3. 排查构造函数代码问题 #

错误栈指向构造函数类型推断失败，检查项目中所有构造函数：

• 确保子类构造函数的super调用参数类型与父类定义匹配
• 避免在超类初始化参数中使用未明确类型的变量
• 若使用了超级参数语法，明确声明类型，示例：

  // 不推荐：可能触发类型推断错误
  class Child extends Parent {
    Child(super.name);
  }
  // 改为明确类型声明
  class Child extends Parent {
    Child(String super.name);
  }
  

4. 禁用增量编译 #

在项目根目录的gradle.properties中添加：

org.gradle.caching=false
org.gradle.parallel=false

同时修改android/app/build.gradle：

android {
    ...
    compileOptions {
        ...
        incremental = false
    }
}

5. 重新创建项目 #

若以上方法均无效，用最新稳定版Flutter创建全新项目，逐步迁移现有代码，排查是否为项目初始配置或代码引入的问题。

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