react-native-image-crop-picker的ImagePicker.openCropper()在Android端抛出未知错误

嘿，我之前集成这个库的时候也碰到过一模一样的「Unknown Error」坑，折腾了好一阵才解决，给你几个排查和修复的方向，你可以挨个试试：

• 检查Android权限与Manifest配置
  这是最容易踩的坑！先确认AndroidManifest.xml里的权限和Provider有没有加全：

  1. 权限部分（同时适配Android 13+和旧版本）：

     <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
     <!-- 仅针对Android 12及以下版本生效 -->
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
     

  2. 必须在<application>标签内添加UCrop的Provider配置：

     <provider
         android:name="com.yalantis.ucrop.UCropProvider"
         android:authorities="${applicationId}.ucrop.provider"
         android:exported="false"
         android:grantUriPermissions="true">
         <meta-data
             android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/ucrop_provider_paths" />
     </provider>
     

  3. 确保res/xml目录下存在ucrop_provider_paths.xml文件，内容如下：

     <?xml version="1.0" encoding="utf-8"?>
     <paths>
         <external-path name="external_files" path="." />
     </paths>
     

• 清理Android缓存并重新构建
  Android的缓存经常会搞出莫名其妙的问题，试试进入项目的android目录执行清理命令：

  cd android && ./gradlew clean
  

  清理完成后重新运行你的RN项目，看看错误是否消失。

• 检查裁剪参数与URI合法性
  调用openCropper时，要注意传入的path参数必须是Android系统能安全访问的URI：

  • 绝对不能直接用file://开头的URI（Android 7+禁止跨应用访问这类URI），尽量使用content://或者FileProvider生成的URI。
  • 给你一个正确的调用示例参考：

    ImagePicker.openCropper({
      path: validImageUri, // 这里要传入合法的content://格式URI
      width: 300,
      height: 400,
      cropping: true
    }).then(croppedImage => {
      // 处理裁剪后的图片
    }).catch(err => {
      console.error('裁剪出错:', err);
    });
    

• 适配Target SDK版本与动态权限
  如果你的项目targetSdkVersion是33及以上，Android 13+的媒体权限规则变了：

  • 必须动态申请READ_MEDIA_IMAGES权限，而不是旧的存储权限。可以用react-native-permissions来处理：

    import { request, PERMISSIONS, RESULTS } from 'react-native-permissions';
    
    const requestImagePermission = async () => {
      const permissionResult = await request(PERMISSIONS.ANDROID.READ_MEDIA_IMAGES);
      if (permissionResult === RESULTS.GRANTED) {
        // 权限通过，执行裁剪操作
      } else {
        // 提示用户开启必要权限
      }
    };
    

• 检查版本兼容性
  确认react-native-image-crop-picker的版本和你的React Native版本适配，比如RN 0.70+建议使用库的最新稳定版，避免版本不兼容导致的隐藏错误。

备注：内容来源于stack exchange，提问作者Koddi Angelo Evangelista