在使用 react-native-image-crop-picker 库时，从相册选择图片上传成功，但使用相机拍摄图片上传却出现 504 超时错误？本文将深入探讨这个问题，分析可能的原因，并提供详细的解决方案，确保相机拍摄的图片也能顺利上传到服务器。通过修改文件上传的格式，区分相册和相机，针对不同平台进行差异化处理，最终解决上传问题。
在使用 React Native 开发应用时，经常需要用到图片上传功能。react-native-image-crop-picker 是一个非常流行的图片选择和裁剪库，可以方便地从相册选择图片或者使用相机拍摄图片。然而，在实际使用中，可能会遇到一个问题：从相册选择的图片可以成功上传，但使用相机拍摄的图片上传却失败，并出现类似 AxiosError: Request failed with status code 504 的错误。本文将深入分析这个问题，并提供详细的解决方案。
问题分析
出现这种问题的根本原因在于 ImagePicker.openCamera 和 ImagePicker.openPicker 返回的数据格式可能存在差异，导致上传时服务器无法正确解析。此外，不同平台（Android 和 iOS）在文件路径处理上也可能存在差异。
具体来说，可能存在以下几个方面的问题：
- 文件路径格式： ImagePicker.openCamera 返回的文件路径可能包含 file:// 前缀，而服务器可能无法识别这种格式。
- MIME 类型： 相机拍摄的图片和相册选择的图片的 MIME 类型可能不同，导致服务器无法正确处理。
- 文件大小： 相机拍摄的图片通常比相册选择的图片大，可能超过服务器允许的最大文件大小限制。
- FormData 格式： FormData 的构建方式可能存在问题，导致服务器无法正确解析上传的文件。
解决方案
针对以上问题，我们可以采取以下步骤来解决相机上传图片失败的问题：
1. 区分相册和相机，使用不同的上传处理函数
为了更好地处理来自不同来源的图片，建议分别创建 uploadPhotoFromLibrary 和 uploadPhotoFromCamera 函数，用于处理相册选择和相机拍摄的图片。
const uploadPhotoFromLibrary = image => {
const file = {
uri: image.path,
name: image.path.split("/").pop(),
type: image.mime,
};
return file;
};
const uploadPhotoFromCamera = image => {
const file = {
name: image?.path.split("/").pop(),
type: image?.mime,
uri:
Platform.OS === 'android' ? image?.path : image?.path.replace('file://', ''),
};
return file;
};在 uploadPhotoFromCamera 函数中，我们根据平台的不同，对文件路径进行处理。在 iOS 平台上，我们需要移除 file:// 前缀，而在 Android 平台上则不需要。
2. 修改 FormData 的构建方式
在 uploadFile 函数中，确保 FormData 的构建方式正确。
static uploadFile = async (filePath: string, idToken: string): Promise=> { return new Promise(async (resolve, reject) => { console.log("filepath: " + filePath); const formData = new FormData(); formData.append('file', { name: 'profileImage', uri: filePath, // 直接使用处理后的 filePath type: 'image/jpg' // 确保 MIME 类型正确 }); try { const response = await axios.post(`${API_BASE_URL}`, formData, { headers: { Accept: 'application/json', 'Content-Type': 'multipart/form-data', Authorization: idToken } }); resolve(response); } catch (error) { console.error(error); reject(error); } }) }
注意以下几点：
- uri 属性直接使用处理后的 filePath，不再添加 file:// 前缀。
- 确保 type 属性的 MIME 类型正确，例如 image/jpg 或 image/png。
- name 属性可以自定义，但建议保持一致。
3. 调整图片质量和大小
如果相机拍摄的图片过大，可以尝试调整图片质量和大小，以减少上传的数据量。可以在 ImagePicker.openCamera 的配置中添加 width、height 和 quality 选项。
const CONFIG_IMAGE_CROP_INVOICE = {
freeStyleCropEnabled: true,
cropperChooseText: 'Crop',
cropperCancelText: 'Cancel',
cropperToolbarTitle: 'Edit Image',
cropperToolbarColor: '#2196F3',
width: 1200,
height: 1500,
cropping: true,
forceJpg: true,
enableRotationGesture: true,
quality: 0.8, // 调整图片质量，范围为 0 到 1
};4. 完整代码示例
下面是完整的代码示例，展示了如何使用上述解决方案：
import ImagePicker from 'react-native-image-crop-picker';
import { Platform } from 'react-native';
import axios, { AxiosResponse } from 'axios';
const API_BASE_URL = 'YOUR_API_BASE_URL'; // 替换为你的 API 地址
const CONFIG_IMAGE_CROP_INVOICE = {
freeStyleCropEnabled: true,
cropperChooseText: 'Crop',
cropperCancelText: 'Cancel',
cropperToolbarTitle: 'Edit Image',
cropperToolbarColor: '#2196F3',
width: 1200,
height: 1500,
cropping: true,
forceJpg: true,
enableRotationGesture: true,
quality: 0.8,
};
const uploadPhotoFromLibrary = image => {
const file = {
uri: image.path,
name: image.path.split("/").pop(),
type: image.mime,
};
return file;
};
const uploadPhotoFromCamera = image => {
const file = {
name: image?.path.split("/").pop(),
type: image?.mime,
uri:
Platform.OS === 'android' ? image?.path : image?.path.replace('file://', ''),
};
return file;
};
const choosePhotoFromLibrary = () => {
ImagePicker.openPicker(CONFIG_IMAGE_CROP_INVOICE)
.then(image => {
console.log(image);
const file = uploadPhotoFromLibrary(image);
uploadFile(file.uri, 'YOUR_ID_TOKEN'); // 替换为你的 idToken
})
.catch(e => {
console.log(e);
});
}
const takePhotoFromCamera = () => {
ImagePicker.openCamera(CONFIG_IMAGE_CROP_INVOICE)
.then(async image => {
console.log(image);
const file = uploadPhotoFromCamera(image);
uploadFile(file.uri, 'YOUR_ID_TOKEN'); // 替换为你的 idToken
})
.catch(e => {
console.log(e);
});
}
static uploadFile = async (filePath: string, idToken: string): Promise => {
return new Promise(async (resolve, reject) => {
console.log("filepath: " + filePath);
const formData = new FormData();
formData.append('file', {
name: 'profileImage',
uri: filePath,
type: 'image/jpg'
});
try {
const response = await axios.post(`${API_BASE_URL}`, formData, {
headers: {
Accept: 'application/json',
'Content-Type': 'multipart/form-data',
Authorization: idToken
}
});
resolve(response);
} catch (error) {
console.error(error);
reject(error);
}
})
} 5. 服务器端验证
除了客户端的修改，还需要在服务器端进行验证，确保服务器能够正确处理上传的文件。
- 检查 Content-Type： 确保服务器能够正确解析 Content-Type 为 multipart/form-data 的请求。
- 处理文件路径： 如果服务器需要特定的文件路径格式，需要进行相应的处理。
- 限制文件大小： 为了防止恶意上传，建议在服务器端限制文件大小。
总结
通过以上步骤，我们可以有效地解决 react-native-image-crop-picker 中相机上传图片失败的问题。关键在于区分相册和相机，针对不同平台进行差异化处理，并确保 FormData 的构建方式正确。同时，还需要在服务器端进行验证，确保服务器能够正确处理上传的文件。希望本文能够帮助你解决实际开发中遇到的问题。
