Flutter项目iOS构建报错：flutter_inappwebview_ios编译失败

问题核心 #

Xcode16对Swift API的兼容性校验更严格，旧版flutter_inappwebview_ios插件代码因API变动出现方法歧义（evaluateJavaScript签名冲突）和重写方法不匹配问题，导致Swift编译失败。

可行解决方案 #

1. 锁定兼容版本 #

针对你的Flutter SDK（3.0.0~3.4.0），在pubspec.yaml中指定适配Xcode16的插件版本：

flutter_inappwebview: ^5.8.0

若此版本仍有问题，可尝试降级到^5.7.2+1，该版本对旧Flutter SDK和新Xcode的兼容性更稳定。

2. 手动修复插件源码（版本锁定无效时用） #

进入项目路径ios/Pods/flutter_inappwebview_ios/Classes/InAppWebView.swift，修改两处问题：

• 解决方法歧义：把所有evaluateJavaScript(_:completionHandler:)的调用明确指定为父类方法，示例：

  // 原代码
  evaluateJavaScript(script) { result, error in
      // 逻辑内容
  }
  // 修改后
  super.evaluateJavaScript(script, completionHandler: { result, error in
      // 逻辑内容
  })
  

• 解决重写不匹配：找到提示“Method does not override any method from its superclass”的方法，修正签名与WKWebView父类方法一致。比如将参数类型从WKNavigation!改为WKNavigation?：

  override func webView(_ webView: WKWebView, didFinish navigation: WKNavigation?) {
      // 原逻辑内容
  }
  

3. 彻底清理构建缓存 #

执行以下命令清除旧编译产物，避免缓存干扰：

flutter clean
cd ios && pod deintegrate && pod install && cd ..
flutter build ios --debug

4. 调整Xcode编译配置 #

打开项目的Xcode工程，修改Build Settings：

• 将Swift Language Version设置为Swift 5.0及以上
• 若仍有编译错误，临时关闭Strict Swift Checking选项作为过渡方案

验证流程 #

1. 模拟器运行：执行flutter run确认编译正常
2. TestFlight上传：执行flutter build ios --release后，通过Xcode上传至App Store Connect

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