关闭空安全时追踪Flutter构建报错的正确命令是什么

架构老林

2026-8-30

问题背景

在项目android目录执行./gradlew :app:assembleDebug --stacktrace --warning-mode all命令时，抛出空安全相关报错：

Error: Cannot run with sound null safety, because the following dependencies don't support null safety:
package:tinycolor
package:open_iconic_flutter
核心原因是上述两个依赖包不支持空安全，默认启用的健全空安全机制阻止了构建流程。

在项目根目录执行flutter run --no-sound-null-safety运行项目时触发构建失败，但不知道关闭空安全场景下输出完整栈追踪的正确命令，无法定位失败根因。
曾尝试在android目录执行./gradlew :app:assembleDebug --stacktrace --warning-mode all ----no-sound-null-safety，该命令无法生效。

正确排查命令

之前命令无效的核心原因是：--no-sound-null-safety是Flutter工具链的前端编译参数，不是Gradle原生支持的命令参数，直接拼在gradlew命令后无法被识别传递。根据排查场景不同，可选择以下两种正确命令：

日常运行+全量日志排查
直接在项目根目录执行带verbose参数的Flutter运行命令，会自动关闭健全空安全，同时打印全量构建日志、完整错误栈追踪：
```
flutter run --no-sound-null-safety -v
```
其中-v是--verbose的简写，会输出从依赖拉取到编译打包全流程的详细日志，可直接定位构建失败的具体触发点。
单独触发Gradle构建场景
如果需要直接调用Gradle命令完成构建、输出栈信息，需要通过Gradle的项目属性参数把空安全配置传递给Flutter编译插件，在android目录下执行以下命令：
```
./gradlew :app:assembleDebug --stacktrace --warning-mode all -Pextra-front-end-options=--no-sound-null-safety
```
该命令会在构建时把--no-sound-null-safety参数传递给Flutter前端编译器，既保留Gradle的栈追踪、全量警告输出能力，也能正常关闭健全空安全校验。