React Native集成Firebase Firestore时iOS端createItemModels错误求助

问题背景 #

操作流程：

• 安装@react-native-firebase/firestore
• 执行cd ios && pod install，触发错误：The Swift pod 'FirebaseFirestore' depends upon 'FirebaseCoreExtension' and 'FirebaseFirestoreInternal', which do not define modules.
• 手动将相关依赖添加到Podfile后重新执行pod install
• 执行cd .. && react-native run-ios，出现新错误：

createItemModels creation requirements should not create capability item model for a capability item model that already exists.

疑问：该错误是否由未注册Apple开发者计划导致？

环境信息 #

package.json #

{
  "name": "app",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "android": "react-native run-android",
    "ios": "react-native run-ios",
    "lint": "eslint .",
    "start": "react-native start",
    "test": "jest"
  },
  "dependencies": {
    "@react-native-firebase/app": "^18.7.3",
    "@react-native-firebase/auth": "^18.7.3",
    "@react-native-firebase/firestore": "^18.7.3",
    "@react-native-masked-view/masked-view": "^0.3.1",
    "@react-navigation/bottom-tabs": "^6.5.11",
    "@react-navigation/native": "^6.1.9",
    "@react-navigation/native-stack": "^6.9.17",
    "@tsconfig/react-native": "^3.0.2",
    "react": "18.2.0",
    "react-native": "0.73.0",
    "react-native-linear-gradient": "^2.8.3",
    "react-native-safe-area-context": "^4.8.1",
    "react-native-screens": "^3.18.0",
    "react-native-swiper": "^1.6.0",
    "react-native-vector-icons": "^10.0.3",
    "react-native-webview": "^13.6.3"
  },
  "devDependencies": {
    "@babel/core": "^7.20.0",
    "@babel/preset-env": "^7.20.0",
    "@babel/runtime": "^7.20.0",
    "@react-native/babel-preset": "^0.73.18",
    "@react-native/eslint-config": "^0.73.1",
    "@react-native/metro-config": "^0.73.2",
    "@react-native/typescript-config": "^0.73.1",
    "@types/react": "^18.2.6",
    "@types/react-native-vector-icons": "^6.4.18",
    "@types/react-test-renderer": "^18.0.0",
    "babel-jest": "^29.6.3",
    "babel-plugin-module-resolver": "^5.0.0",
    "eslint": "^8.19.0",
    "jest": "^29.6.3",
    "metro-react-native-babel-preset": "^0.77.0",
    "prettier": "2.8.8",
    "react-test-renderer": "18.2.0",
    "typescript": "5.0.4"
  },
  "engines": {
    "node": ">=18"
  }
}

/ios/Podfile #

# Resolve react_native_pods.rb with node to allow for hoisting
require Pod::Executable.execute_command('node', ['-p',
  'require.resolve(
    "react-native/scripts/react_native_pods.rb",
    {paths: [process.argv[1]]},
  )', __dir__]).strip

platform :ios, min_ios_version_supported
prepare_react_native_project!

# If you are using a `react-native-flipper` your iOS build will fail when `NO_FLIPPER=1` is set.
# because `react-native-flipper` depends on (FlipperKit,...) that will be excluded
#
# To fix this you can also exclude `react-native-flipper` using a `react-native.config.js`
# ```js
# module.exports = {
#   dependencies: {
#     ...(process.env.NO_FLIPPER ? { 'react-native-flipper': { platforms: { ios: null } } } : {}),
# ```
flipper_config = ENV['NO_FLIPPER'] == "1" ? FlipperConfiguration.disabled : FlipperConfiguration.enabled

linkage = ENV['USE_FRAMEWORKS']
if linkage != nil
  Pod::UI.puts "Configuring Pod with #{linkage}ally linked Frameworks".green
  use_frameworks! :linkage => linkage.to_sym
end

target 'app' do
  config = use_native_modules!

  use_react_native!(
    :path => config[:reactNativePath],
    # Enables Flipper.
    #
    # Note that if you have use_frameworks! enabled, Flipper will not work and
    # you should disable the next line.
    :flipper_configuration => flipper_config,
    # An absolute path to your application root.
    :app_path => "#{Pod::Config.instance.installation_root}/.."
  )

  target 'appTests' do
    inherit! :complete
    # Pods for testing
  end

  post_install do |installer|
    # https://github.com/facebook/react-native/blob/main/packages/react-native/scripts/react_native_pods.rb#L197-L202
    react_native_post_install(
      installer,
      config[:reactNativePath],
      :mac_catalyst_enabled => false
    )
  end
  
  pod 'Firebase', :modular_headers => true
  pod 'FirebaseCoreInternal', :modular_headers => true
  pod 'GoogleUtilities', :modular_headers => true
  pod 'FirebaseCore', :modular_headers => true
  pod 'FirebaseAuth', :modular_headers => true
  pod 'FirebaseCoreExtension', :modular_headers => true
  pod 'FirebaseFirestoreInternal', :modular_headers => true
end

解决方案 #

首先明确：该错误和未注册Apple开发者计划无关，未注册账号仍可在iOS模拟器运行项目。问题源于构建缓存冲突或Pod配置重复，按以下步骤修复：

1. 彻底清理构建缓存 #

• 关闭Xcode
• 删除iOS构建目录：rm -rf ios/build
• 清理Pod依赖：cd ios && pod deintegrate && pod clean
• 重新安装Pods：pod install

2. 修正Podfile配置 #

手动添加的Firebase依赖会导致重复声明，移除Podfile末尾手动添加的所有Firebase相关pod行，改用自动配置+模块化头设置：

# 移除这些行：
pod 'Firebase', :modular_headers => true
pod 'FirebaseCoreInternal', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'FirebaseAuth', :modular_headers => true
pod 'FirebaseCoreExtension', :modular_headers => true
pod 'FirebaseFirestoreInternal', :modular_headers => true

然后在target 'app' do块内、use_native_modules!之后添加以下配置，统一为Firebase依赖启用模块化头：

pre_install do |installer|
  installer.pod_targets.each do |pod|
    if pod.name.start_with?('Firebase') || pod.name == 'GoogleUtilities'
      pod.build_configurations.each do |config|
        config.build_settings['CLANG_ENABLE_MODULES'] = 'YES'
      end
    end
  end
end

如果你的Podfile启用了use_frameworks!，确保设置为静态链接（Firebase推荐）：

use_frameworks! :linkage => :static

修改后重新执行pod install

3. 检查Xcode Capability配置 #

• 打开ios/app.xcworkspace，进入项目Target → Signing & Capabilities
• 检查是否有重复添加的Capability（如Cloud Firestore），移除多余条目
• 确认Bundle Identifier格式正确（无需开发者账号也可使用默认测试ID）

4. 重新运行项目 #

执行cd .. && react-native run-ios --clean，强制清理缓存后启动项目

错误原因说明 #

这个错误是Xcode处理项目Capability时检测到重复条目导致的，通常由Pod安装时重复注入配置、手动修改Podfile引发的依赖冲突造成，和Apple开发者账号状态无关。

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