iOS项目引入Google-Maps-iOS-Utils时提示‘Google-Maps-iOS-Utils/GoogleMapsUtils.modulemap’找不到的问题求助

阿华AIGC实验室

2026-4-13

嘿，我看了你贴的Podfile内容，遇到这个Google-Maps-iOS-Utils/GoogleMapsUtils.modulemap找不到的问题其实挺常见的，大概率是版本兼容、Pod缓存或者配置小疏漏导致的，给你几个实用的解决步骤试试：

首先先把你提供的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!

# Add Google Maps pod
pod 'GoogleMaps'
pod 'Google-Maps-iOS-Utils'
pod 'react-native-google-maps', :path => '../node_modules/react-native-map

可能的解决步骤：

修正react-native-google-maps的路径：你Podfile里最后一行的路径写的是../node_modules/react-native-map，明显少了后面的-google-maps，这会导致依赖加载异常，先把它修正为：
```
pod 'react-native-google-maps', :path => '../node_modules/react-native-google-maps'
```
确保版本兼容性：Google-Maps-iOS-Utils和GoogleMaps的版本必须严格匹配，比如如果你用的是GoogleMaps 6.x版本，那Google-Maps-iOS-Utils也要对应6.x系列。你可以在Podfile里指定明确的兼容版本，比如：
```
pod 'GoogleMaps', '~> 6.2.0'
pod 'Google-Maps-iOS-Utils', '~> 6.2.0'
```
清理Pod缓存并重新安装：缓存问题经常会导致这类找不到文件的错误，按顺序执行以下命令：
```
rm -rf Podfile.lock
rm -rf Pods
pod cache clean --all
pod install
```
检查Xcode项目配置：打开Xcode后，确保你的主项目的Build Settings里，Header Search Paths和Framework Search Paths都包含$(inherited)，这会让Xcode自动读取Pods的配置路径。如果没有的话，手动添加进去。