Flutter集成iOS原生项目时FlutterPluginRegistrant因sqflite_darwin头文件缺失编译失败

这种混合开发里的依赖头文件路径问题真的很头疼，我之前在iOS+Flutter的项目里也碰到过类似的情况，给你几个不用修改插件源码就能解决的方案，你可以挨个试试：

方案1：手动调整sqflite_darwin的头文件搜索路径 #

打开Xcode，定位到Pods项目里的sqflite_darwin Target，按以下步骤操作：

1. 选中sqflite_darwin → 切换到Build Settings标签页
2. 搜索Header Search Paths（头文件搜索路径）
3. 点击+号，添加路径$(PODS_TARGET_SRCROOT)/include，并将路径的搜索方式设置为Recursive（递归搜索）
4. 保存配置后，执行Product > Clean Build Folder（快捷键Cmd+Shift+K），再重新编译项目

方案2：更新依赖版本，修复版本兼容问题 #

你当前使用的CocoaPods 1.16.2和Xcode 16.3属于比较新的版本，可能和旧版sqflite_darwin存在兼容问题：

1. 切换到你的Flutter模块目录，执行命令更新sqflite插件：

   flutter pub upgrade sqflite
   

2. 回到iOS原生项目目录，先彻底移除现有Pods依赖：

   pod deintegrate
   rm -rf Pods Podfile.lock .symlinks
   

3. 再执行pod install重新安装依赖，完成后打开Xcode重新编译

方案3：通过Podfile配置强制修正sqflite_darwin的头文件路径 #

在iOS项目的Podfile末尾添加以下post_install钩子，自动调整sqflite_darwin的头文件配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == 'sqflite_darwin'
      target.build_configurations.each do |config|
        # 添加include目录到头文件搜索路径
        config.build_settings['HEADER_SEARCH_PATHS'] = "$(inherited) $(PODS_TARGET_SRCROOT)/include"
        # 修正私有头文件的路径引用
        target.private_header_files = target.private_header_files.map do |path|
          path.gsub('include/sqflite_darwin/', '')
        end
      end
    end
  end
end

添加完成后，执行pod install生效配置，再尝试编译项目

方案4：彻底清理所有缓存，重建依赖链 #

有时候残留的缓存会导致CocoaPods解析路径混乱，执行以下完整清理步骤：

1. 在Flutter模块目录执行：

   flutter clean && flutter pub get
   

2. 在iOS项目目录执行：

   pod deintegrate
   rm -rf ~/Library/Developer/Xcode/DerivedData
   

3. 删除iOS项目根目录的Pods文件夹、Podfile.lock文件
4. 重新执行pod install，打开Xcode后先清理构建文件夹（Cmd+Shift+K），再编译

问题原因说明 #

出现这个问题的核心原因是sqflite_darwin的Podspec配置可能没有正确将include/sqflite_darwin目录的头文件暴露给依赖它的FlutterPluginRegistrant，或者CocoaPods在混合开发场景下解析头文件路径时出现了偏差，导致#import "include/sqflite_darwin/SqflitePluginPublic.h"无法找到对应文件。

内容来源于stack exchange