集成Flutter Crashlytics遇问题：路径错误与Xcode符号未定义

1. 修复Pod Install的路径识别问题 #

出现该警告是因为Firebase Crashlytics的上传符号脚本硬编码了错误的项目路径，或是FlutterFire CLI配置时生成了错误的路径引用。解决步骤：

• 打开Xcode，加载项目的ios/Runner.xcodeproj
• 进入Runner target的Build Phases标签页
• 找到名为Upload Debug Symbols to Firebase的Run Script
• 将脚本中硬编码的错误路径（如/Users/hazratbilal/Documents/HHD/Runner.xcodeproj）替换为相对路径："${PROJECT_DIR}/Runner.xcodeproj"
• 保存配置后，回到ios目录重新执行pod install
• 若问题仍存在，重新运行flutterfire configure命令，确保配置时选择正确的项目路径

2. 解决Xcode Undefined Symbols链接错误 #

该错误多由Firebase依赖未正确链接、初始化缺失或缓存问题导致，按以下步骤排查：

• 清理项目缓存：
  1. 执行flutter clean
  2. 删除ios目录下的Pods文件夹、Podfile.lock文件
  3. 进入ios目录，执行pod install --repo-update
• 确保Firebase初始化：
  在main.dart入口函数中添加初始化代码：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    runApp(const MyApp());
  }
  

• 检查Xcode构建配置：
  1. 打开Xcode的Runner target，进入Build Settings
  2. 确保Other Linker Flags包含$(inherited)（自动引入Pods的链接配置）
  3. 确认Framework Search Paths包含$(inherited)和${PODS_ROOT}/Firebase/Crashlytics等路径
• 调整Podfile框架配置：
  将Podfile中的use_frameworks!修改为静态链接模式（部分Flutter版本对动态框架支持不佳）：

  use_frameworks! :linkage => :static
  

  修改后重新执行pod install

3. Crashlytics符号上传：自动还是手动？ #

• 正常情况下，FlutterFire CLI添加的Upload Debug Symbols to Firebase Run Script会在每次Xcode构建后自动上传符号，无需手动操作。
• 若自动上传失败（如路径错误、权限问题），则需手动上传：
  1. 定位dSYM文件：Xcode构建后，dSYM通常在~/Library/Developer/Xcode/DerivedData/Runner-xxx/Build/Products/Release-iphoneos/Runner.app.dSYM
  2. 执行上传命令（替换为实际文件路径）：

     ./Pods/FirebaseCrashlytics/upload-symbols -gsp ios/GoogleService-Info.plist -p ios ~/Library/Developer/Xcode/DerivedData/Runner-xxx/Build/Products/Release-iphoneos/Runner.app.dSYM
     

• 注意：Debug模式下符号上传可能默认禁用，可在Xcode的Build Phases脚本中调整条件，确保Debug构建也上传符号。

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