Flutter iOS Archive报错：module 'flutter_webview_plugin'未找到求助

报错详情 #

编译命令及核心错误 #

CompileC /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Objects-normal/arm64/GeneratedPluginRegistrant.o /Users/kkk/Desktop/wooribannet/ios/Runner/GeneratedPluginRegistrant.m normal arm64 objective-c com.apple.compilers.llvm.clang.1_0.compiler (in target 'Runner' from project 'Runner')
    cd /Users/kkk/Desktop/wooribannet/ios
    /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -x objective-c -target arm64-apple-ios9.0 -fmessage-length\=0 -fdiagnostics-show-note-include-stack -fmacro-backtrace-limit\=0 -std\=gnu99 -fobjc-arc -fmodules -gmodules -fmodules-cache-path\=/Users/kkk/Library/Developer/Xcode/DerivedData/ModuleCache.noindex -fmodules-prune-interval\=86400 -fmodules-prune-after\=345600 -fbuild-session-file\=/Users/kkk/Library/Developer/Xcode/DerivedData/ModuleCache.noindex/Session.modulevalidation -fmodules-validate-once-per-build-session -Wnon-modular-include-in-framework-module -Werror\=non-modular-include-in-framework-module -Wno-trigraphs -fpascal-strings -Os -fno-common -Wno-missing-field-initializers -Wno-missing-prototypes -Werror\=return-type -Wunreachable-code -Wno-implicit-atomic-properties -Werror\=deprecated-objc-isa-usage -Wno-objc-interface-ivars -Werror\=objc-root-class -Wno-arc-repeated-use-of-weak -Wimplicit-retain-self -Wduplicate-method-match -Wno-missing-braces -Wparentheses -Wswitch -Wunused-function -Wno-unused-label -Wno-unused-parameter -Wunused-variable -Wunused-value -Wempty-body -Wuninitialized -Wconditional-uninitialized -Wno-unknown-pragmas -Wno-shadow -Wno-four-char-constants -Wno-conversion -Wconstant-conversion -Wint-conversion -Wbool-conversion -Wenum-conversion -Wno-float-conversion -Wnon-literal-null-conversion -Wobjc-literal-conversion -Wshorten-64-to-32 -Wpointer-sign -Wno-newline-eof -Wno-selector -Wno-strict-selector-match -Wundeclared-selector -Wdeprecated-implementations -Wno-implicit-fallthrough -DNS_BLOCK_ASSERTIONS\=1 -DOBJC_OLD_DISPATCH_PROTOTYPES\=0 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.1.sdk -fstrict-aliasing -Wprotocol -Wdeprecated-declarations -g -fvisibility\=hidden -Wno-sign-conversion -Winfinite-recursion -Wcomma -Wblock-capture-autoreleasing -Wstrict-prototypes -Wno-semicolon-before-method-body -iquote /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Runner-generated-files.hmap -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Runner-own-target-headers.hmap -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Runner-all-target-headers.hmap -iquote /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Runner-project-headers.hmap -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/BuildProductsPath/Release-iphoneos/include -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/DerivedSources-normal/arm64 -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/DerivedSources/arm64 -I/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/DerivedSources -F/Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/BuildProductsPath/Release-iphoneos -MMD -MT dependencies -MF /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Objects-normal/arm64/GeneratedPluginRegistrant.d --serialize-diagnostics /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Objects-normal/arm64/GeneratedPluginRegistrant.dia -c /Users/kkk/Desktop/wooribannet/ios/Runner/GeneratedPluginRegistrant.m -o /Users/kkk/Library/Developer/Xcode/DerivedData/Runner-fkufrnoydejulxbgtamtkhrugtau/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Runner.build/Release-iphoneos/Runner.build/Objects-normal/arm64/GeneratedPluginRegistrant.o

/Users/kkk/Desktop/wooribannet/ios/Runner/GeneratedPluginRegistrant.m:12:9: fatal error: module 'flutter_webview_plugin' not found

@import flutter_webview_plugin;

1 error generated.

解决办法 #

方案一：替换为官方维护的webview_flutter插件（推荐） #

flutter_webview_plugin已停止维护多年，官方推出的webview_flutter适配性、稳定性更优：

• 删除旧插件：

  flutter pub remove flutter_webview_plugin
  

• 添加官方插件：

  flutter pub add webview_flutter
  

• 替换代码中flutter_webview_plugin的调用逻辑，比如将WebviewScaffold替换为WebView组件，API用法差异不大，适配成本低。
• 清理缓存并重建项目：

  flutter clean
  cd ios && pod install && cd ..
  

• 重新尝试Archive打包。

方案二：临时修复旧插件打包问题（仅应急用） #

若暂时无法迁移，可尝试以下操作：

• 清理项目缓存并拉取依赖：

  flutter clean
  flutter pub get
  

• 进入iOS目录重置Pod依赖：

  cd ios
  rm -rf Podfile.lock Pods
  pod install --repo-update
  

• 打开Xcode，执行Command+Shift+K清理项目，再重新Archive。
• 检查Xcode Build Settings中Enable Modules (C and Objective-C)是否设为Yes，确保模块支持开启。

注意：临时修复只是权宜之计，旧插件后续会出现更多适配问题，建议尽快迁移到官方插件。

内容的提问来源于stack exchange，提问作者김선생