Android 11下react-native-signature-capture无法用formdata传签名到API

1. 跳过冗余流程，直接获取可上传的签名文件路径 #

• 不要依赖系统相册的文件路径作为上传源：Android 11 分区存储规则下，从系统相册返回的content://格式URI无法直接被上传逻辑识别，高频触发file not found类报错。
• 手写签名生成完成时，react-native-signature-capture的onSaveEvent回调会直接返回应用私有目录下的签名文件绝对路径（默认输出为png格式），这个路径属于应用私有存储范围，不需要额外申请权限，具备完整读写访问权限，可以直接用作上传源。
  这个路径就是上传需要的最终本地资源，完全不需要等文件同步到系统相册后再回读，能绕开90%的权限和路径问题。

2. 构造符合React Native规范的FormData对象 #

RN环境下的FormData追加文件的语法和Web端有差异，直接套用Web端的Blob写法会出现上传失败问题，正确的追加格式如下：

// 从组件回调拿到本地签名文件路径
const localSignPath = signCallbackEvent.path;

// 初始化FormData
const uploadFormData = new FormData();
// 按照后端接口要求的字段名追加文件参数
uploadFormData.append('后端要求的文件字段名', {
  uri: localSignPath,
  type: 'image/png',
  name: `user_sign_${Date.now()}.png`
});

3. 发起上传请求 #

请求时需要手动指定multipart/form-data类型的请求头，避免RN自动推断头部格式导致后端解析失败：

fetch('你的后端Web API接口地址', {
  method: 'POST',
  headers: {
    'Content-Type': 'multipart/form-data',
    // 接口需要的鉴权参数（如token）正常在此处配置即可
  },
  body: uploadFormData
})
.then(response => response.json())
.then(uploadRes => {
  // 上传成功后，如果需要同步保存到系统相册，再触发你现有的存相册逻辑即可
  console.log('上传成功', uploadRes);
})
.catch(uploadErr => {
  console.error('上传失败', uploadErr);
});

• 不要把签名文件读成base64格式再上传：RN的FormData可以直接读取本地文件uri上传，转base64会让传输体积膨胀33%以上，大文件还容易触发内存溢出。
• 如果你确实需要读取之前已经存到系统公共相册的签名文件做上传，需要通过MediaStore查询拿到对应文件的真实本地绝对路径，不能直接把content://开头的URI传给FormData的uri字段。
• 若涉及读取公共相册文件的逻辑，需要确认已在AndroidManifest.xml中配置对应版本的存储读取权限，否则会因为权限不足读不到文件。

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