Flutter iOS 构建报错 Module 'mobile_scanner' not found 怎么解决？

2026-11-06数据阿明

结论

在 Flutter 项目中使用 mobile_scanner 时，如果 Xcode 在 Runner/GeneratedPluginRegistrant.m 报错 Module 'mobile_scanner' not found，可以先进入项目的 ios 目录运行 pod install --repo-update，再清理构建产物并重新获取 Flutter 依赖。

该插件在 pubspec.yaml 中声明，并通过 package:mobile_scanner/mobile_scanner.dart 导入。这个案例中，更新 CocoaPods 依赖并执行后续 Flutter 命令后，iOS 构建恢复正常。

处理步骤

在 Flutter 项目根目录执行：

cd ios/
pod install --repo-update
cd ..
flutter clean
flutter pub get
flutter run

pod install --repo-update 会在安装 Pods 时更新 CocoaPods 仓库。随后，运行 flutter clean 清理构建产物，再用 flutter pub get 重新获取 Flutter 依赖，最后运行项目。

错误位置与代码背景

报错位置为：

Parse Issue (Xcode): Module 'mobile_scanner' not found
Runner/GeneratedPluginRegistrant.m:83:8

问题中的依赖声明和导入方式如下：

dependencies:
  flutter:
    sdk: flutter
  mobile_scanner: ^3.5.1 # (example version)

import 'package:mobile_scanner/mobile_scanner.dart';

插件通过 GeneratedPluginRegistrant.m 注册。在这个案例中，更新 ios 目录中的 CocoaPods 依赖后，Xcode 完成了构建。

注意事项

请从 Flutter 项目根目录开始执行命令，并在 ios 目录中运行 pod install --repo-update。如果问题仍然存在，仅凭现有信息无法判断是否还有其他环境或配置原因，需要结合实际的 CocoaPods 输出和完整构建日志排查。