旧Flutter代码Build方法失败，集成API后无法运行求助

常见问题排查步骤 #

• 核对依赖版本兼容性
  旧代码依赖可能与当前Flutter版本冲突，尤其是集成API用到的网络库（如dio、http）。打开pubspec.yaml，检查依赖的版本约束，比如将冲突依赖改为宽松约束（如dio: any）测试，执行flutter pub get后重新构建。

• 定位API集成代码错误
  注释新增的API调用代码，确认Build是否恢复正常，逐步排查语法错误：

  • 未定义的变量/方法
  • 异步逻辑错误（如遗漏await）
  • 数据类型不匹配
    重点关注Build日志中的报错行，针对性修正代码。

• 检查平台配置

  • Android：在AndroidManifest.xml添加网络权限

    <uses-permission android:name="android.permission.INTERNET" />
    

    核对android/build.gradle中ext.kotlin_version、com.android.tools.build:gradle版本，匹配当前Flutter要求的版本。
  • iOS：若使用HTTP请求，在Info.plist添加ATS例外

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
    

    执行pod install更新iOS依赖。

• 适配Flutter版本
  旧代码可能基于低版本Flutter，执行flutter doctor检查环境冲突，可尝试切换至旧代码适配的Flutter版本：flutter version <旧版本号>，再重新构建。

• 深度清理缓存
  除flutter clean外，手动删除以下目录后重新执行flutter pub get和构建：

  • Android：android/.gradle、android/build
  • iOS：ios/Pods、ios/.symlinks、ios/Runner.xcworkspace

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