SDK 49升级至51后项目崩溃，多平台报错求助

一、解决 X-React-Native-Project-Root 头部无效字符错误 #

这个错误是项目路径包含特殊字符（空格、中文、非ASCII符号）导致的，按以下操作：

• 把项目迁移到纯英文、无空格、无特殊符号的目录下，比如从/用户/xxx/我的项目改成/Users/xxx/MyExpoProject
• 彻底清除Expo缓存：执行命令 npx expo start --clear

二、修复iOS端Google Maps无法显示问题 #

针对报错 react-native-maps: AirGoogleMaps dir must be added to your xCode project，操作步骤：

• 确保用的是Expo官方地图包：卸载原生react-native-maps，执行 npm uninstall react-native-maps，再安装expo-google-maps：npx expo install expo-google-maps
• 重新生成干净的iOS原生文件：执行 npx expo prebuild --clean，这个命令会自动配置Google Maps所需的目录结构
• 在app.json或app.config.js中确认API密钥配置正确：

{
  "expo": {
    "plugins": [
      [
        "expo-google-maps",
        {
          "apiKey": "你的Google Maps API密钥"
        }
      ]
    ]
  }
}

三、处理函数组件Ref和defaultProps警告 #

• Ref警告：找到涉及的函数组件，用React.forwardRef()包裹，示例：

// 原组件
const Barcode = (props) => { /* 组件逻辑 */ }

// 修改后
const Barcode = React.forwardRef((props, ref) => {
  // 将ref绑定到内部元素
  return <View ref={ref}>{/* 组件内容 */}</View>
})

• defaultProps警告：把defaultProps替换成函数参数默认值，示例：

// 原写法
const Barcode = (props) => { /* 组件逻辑 */ }
Barcode.defaultProps = {
  format: 'QR_CODE'
}

// 修改后
const Barcode = ({ format = 'QR_CODE', ...restProps }) => { /* 组件逻辑 */ }

四、Android应用无法启动的额外修复 #

• 清除Android构建缓存：进入项目android目录，执行 ./gradlew clean，或者直接用 npx expo run:android --clean 重新构建
• 检查android/build.gradle中的SDK版本，确保和Expo SDK 51匹配（编译和目标SDK版本应为34）：

buildscript {
  ext {
    compileSdkVersion = 34
    targetSdkVersion = 34
    minSdkVersion = 24
  }
}

内容的提问来源于stack exchange，提问作者Ал Медиум