iOS应用手动启动崩溃：OpenSSL.framework缺失问题求助

问题核心 #

应用在模拟器中手动点击图标启动时立即崩溃，崩溃日志显示DYLD 1 Library missing，找不到@rpath/OpenSSL.framework/OpenSSL；但通过Xcode运行按钮启动、TestFlight安装的应用均正常。

原因分析 #

1. Xcode运行时会自动注入额外框架搜索路径，弥补配置缺失；
2. TestFlight的Release构建中，依赖可能被静态链接或正确嵌入到应用包内；
3. Debug构建的应用包中，OpenSSL.framework未被正确嵌入，或运行路径配置错误。

解决方案 #

1. 定位引入OpenSSL的依赖 #

先确认是哪个第三方库引入了OpenSSL，在项目根目录执行：

cd ios && grep -r "OpenSSL" Pods/

通常这类问题由react-native-pdf、react-native-blob-util等依赖触发，它们会间接依赖OpenSSL。

2. 检查框架嵌入配置 #

打开Xcode项目，进入应用Target的Build Phases标签：

• 找到Embed Frameworks阶段，查看是否包含OpenSSL.framework；
• 如果没有，点击+按钮，从ios/Pods/OpenSSL/Frameworks（或对应路径）添加该框架；
• 勾选框架右侧的Code Sign On Copy选项。

3. 修正Runpath Search Paths #

进入Target的Build Settings标签，搜索Runpath Search Paths：

• 确保@executable_path/Frameworks在列表中（Debug和Release配置都要检查）；
• 如果缺失，手动添加并设置为$(inherited) @executable_path/Frameworks。

4. 强制静态链接OpenSSL（可选） #

如果动态框架嵌入仍有问题，修改ios/Podfile，在post_install块中添加静态链接配置：

post_install do |installer|
  # 保留原有的post_install配置...
  installer.pods_project.targets.each do |target|
    # 匹配OpenSSL相关Target，名称可能是OpenSSL或openssl-ios等
    if target.name.downcase.include?('openssl')
      target.build_configurations.each do |config|
        config.build_settings['OTHER_LDFLAGS'] = '-static'
        config.build_settings['MACH_O_TYPE'] = 'staticlib'
      end
    end
  end
end

5. 清理并重新构建 #

执行完整的清理构建流程，确保缓存被清除：

# 清理RN项目缓存
yarn clean
# 清理iOS Pods
cd ios && pod deintegrate && rm -rf Podfile.lock && pod install
# 重新构建Debug包
cd .. && react-native run-ios --configuration Debug

验证 #

构建完成后，在模拟器中手动点击应用图标，确认是否正常启动。

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