Flutter项目加载AE经bodymovin导出的Lottie动画失败且编译报错

报错提示中的Execution failed for task ':app:compileFlutterBuildDebug'属于编译阶段抛出的通用错误，本质是Flutter在编译构建资源、处理依赖时执行命令返回了非零退出值，和运行时的网络动画加载逻辑无关，可按照以下步骤依次排查解决。

1. 校验pubspec.yaml资源配置 #

• 核对yaml文件的缩进格式：yaml语法对缩进严格敏感，所有assets相关配置必须使用2个空格做缩进，禁止使用tab制表符，否则会出现配置解析失败。
• 确认配置路径和实际文件存放路径完全匹配：如果项目中optimal.json存放在根目录下的assets文件夹内，配置项需精确写为assets/optimal.json，不要仅写文件夹路径遗漏单个资源的声明。
• 配置修改完成后必须执行flutter pub get，让Flutter识别新的资源路径配置，不要直接执行编译操作。

2. 检查依赖版本兼容性 #

• 核对引入的lottie包版本和当前项目的Flutter SDK版本是否匹配，过低版本的依赖可能存在编译兼容问题，可切换到匹配当前SDK的稳定版本依赖重试。
• 确认代码中的导入路径书写正确，保证为import 'package:lottie/lottie.dart'，无拼写错误。

3. 校验导出的Lottie JSON合法性 #

• bodymovin导出的JSON如果存在语法错误，会导致编译打包时资源解析失败，触发非零退出报错。可使用本地JSON校验工具检查optimal.json是否存在格式问题，比如未闭合的括号、多余的语法符号等。
• 核对bodymovin的导出设置：导出时需关闭Flutter端不兼容的特性选项，比如表达式解析、特定渲染器专属参数，避免导出的JSON包含Flutter端无法识别的语法内容。

4. 清理残留编译缓存 #

• Gradle的历史缓存可能引发无明确原因的编译失败，依次执行以下命令清理环境：
  • 运行flutter clean清除项目历史构建缓存
  • 运行flutter pub get重新拉取所有项目依赖
  • 重新编译运行项目
• Windows平台额外检查：确认项目存放路径不包含中文、特殊符号等非ASCII字符，这类路径会导致Flutter内置Gradle脚本执行权限异常。

5. 获取完整错误栈定位根因 #

• 运行flutter run --stacktrace命令，跳过Gradle的通用报错封装，拿到编译失败的具体堆栈信息，精准定位是资源文件缺失、JSON解析报错、还是依赖类不兼容导致的问题。
• 排查时可临时注释掉代码中的网络动画加载、zip包加载相关逻辑，编译通过后再逐行恢复，缩小问题范围。

内容的提问来源于stack exchange，提问作者Ahmed Khaled Abdalla