Flutter集成libpg_query遇符号查找失败问题求助

我正尝试在Flutter应用中集成libpg_query库，已拉取代码构建后放入Xcode，并遵循Flutter官方文档中iOS C互操作的源码与符号剥离章节操作。通过pg_query.h生成Dart FFI绑定，使用DynamicLibrary.process();加载库，测试阶段及TestFlight发布版均正常，但正式上架App Store后，部分用户调用pg_query_split_with_parser时出现崩溃，报错：Invalid argument(s): Failed to lookup symbol 'pg_query_split_with_parser': dlsym(RTLD_DEFAULT, pg_query_split_with_parser): symbol not found，但我自己从App Store安装应用却能正常运行，请问遗漏了什么配置或操作？

• 检查App Store符号剥离规则差异
  TestFlight与正式App Store的代码优化、符号剥离策略存在差异。需确保pg_query_split_with_parser这类关键符号未被额外剥离：

  • 在Xcode Build Settings中，将Strip Symbols During Copy（对应STRIP_STYLE）设置为Non-Global Symbols，而非All Symbols；
  • 确认Release模式下Deployment Postprocessing（DEPLOYMENT_POSTPROCESSING）的配置，避免过度剥离符号。

• 显式标记符号全局可见性
  C库默认符号可能仅本地可见，需修改libpg_query编译配置，将需要暴露的符号标记为全局：

  • 编译时添加-fvisibility=default参数，或在函数声明前添加__attribute__((visibility("default")))；
  • 重新构建库文件，确保目标符号被标记为全局，避免被App Store的剥离机制移除。

• 调整动态库加载方式
  DynamicLibrary.process()依赖主进程全局符号表，但App Store的优化可能隔离库符号。尝试直接加载嵌入的库文件：

  final libraryPath = 'Frameworks/App.framework/libpg_query.dylib'; // 根据实际路径调整
  final dylib = DynamicLibrary.open(libraryPath);
  

  同时确认库文件已通过Xcode的Copy Files阶段嵌入到App的Frameworks目录，目标设置为Frameworks。

• 验证架构兼容性
  部分用户设备可能使用你未正确编译的架构（如arm64e）：

  • 确保libpg_query编译时包含所有iOS支持的架构（armv7、arm64、arm64e）；
  • Release模式下将Build Active Architecture Only设置为NO，避免仅编译当前测试设备的架构。

• 检查上架包的符号完整性
  下载App Store上的IPA包，使用工具验证符号是否存在：

  # 检查库依赖
  otool -L YourApp.app/Frameworks/libpg_query.dylib
  # 查找目标符号
  nm -g YourApp.app/Frameworks/libpg_query.dylib | grep pg_query_split_with_parser
  

  若符号不存在，说明打包过程中符号被移除，需回溯编译、打包的配置步骤。

内容的提问来源于stack exchange，提问作者Marko Devcic