expo image picker 在 android 设备上默认仅显示系统相册（如“最近”“相机”“截图”等），无法访问外部存储或第三方应用创建的相册；启用 legacy: true 可强制使用旧版原生图库选择器，从而完整列出所有媒体文件夹。
expo image picker 在 android 设备上默认仅显示系统相册（如“最近”“相机”“截图”等），无法访问外部存储或第三方应用创建的相册；启用 legacy: true 可强制使用旧版原生图库选择器，从而完整列出所有媒体文件夹。
在 React Native 的 Expo 项目中，expo-image-picker 是调用设备图库最常用的工具之一。但开发者常遇到一个典型问题：在 Android 设备上调用 launchImageLibraryAsync() 时，界面只显示有限的几个系统相册（例如“所有照片”“相机”“截图”），而用户手动创建的相册、下载的图片文件夹，或由其他应用（如 WhatsApp、Telegram）生成的媒体目录却完全不可见。
根本原因在于：从 Expo SDK 46 起，Android 端默认使用基于 MediaStore 的新图库 UI（即 modern 模式），该模式受 Android 权限模型和媒体索引策略限制，仅展示被系统标记为“可公开访问”的媒体集合；而许多自定义文件夹未被纳入标准媒体数据库，因此被过滤掉。
✅ 解决方案：启用 legacy 模式
只需在配置对象中添加 legacy: true 选项，即可回退至兼容性更强的旧版图库选择器（基于 Intent.ACTION_PICK），它直接遍历设备存储路径，不受 MediaStore 索引限制，能完整呈现所有含图片/视频的文件夹：
const addImage = async () => {
try {
const result = await ImagePicker.launchImageLibraryAsync({
mediaTypes: ImagePicker.MediaTypeOptions.All,
allowsEditing: true,
aspect: [4, 3],
quality: 1,
// ? 关键修复：启用旧版图库选择器（仅对 Android 生效）
legacy: true,
});
if (!result.canceled) {
const image = {
uri: result.uri,
name: result.uri.split('/').pop() || 'image.jpg',
type: 'image/jpeg',
};
const formData = new FormData();
formData.append('image', image);
// 注意：FormData 上传需确保后端支持 multipart/form-data 解析
const response = await axios.post(
`http://141.226.241.38:3001/assets/upload/${props.data._id}`,
formData,
{
headers: {
'Content-Type': 'multipart/form-data',
},
}
);
// 更新本地状态（建议使用更健壮的查找逻辑，避免重复 find）
const assetItem = assets.find(item => item._id === props.data._id);
if (assetItem) {
const updatedAsset = {
...assetItem,
image: [...assetItem.image, image.name],
};
dispatch(updateAsset1({ assets: updatedAsset }));
}
}
} catch (err) {
console.error('Image picker error:', err);
// 建议增加用户友好的错误提示（如 Toast 或 Alert）
}
};⚠️ 注意事项与最佳实践
- legacy: true 仅影响 Android 平台，iOS 会自动忽略该字段，行为保持不变；
- 该选项要求 expo-image-picker 版本 ≥ 12.0.0（推荐使用最新稳定版，如 14.x）；
- 启用后可能略微降低首次加载速度（因需扫描更多路径），但显著提升相册可见性；
- 若仍无法显示某些相册，请检查设备是否启用了「媒体扫描」功能，或尝试重启设备以刷新 MediaStore 索引；
- 安全提示：legacy 模式下用户可选择任意可读文件，务必在服务端校验文件类型与内容，避免恶意上传。
总结来说，legacy: true 不是权宜之计，而是 Expo 官方为解决 Android 相册兼容性问题提供的正式配置项。合理使用它，既能保障用户体验的完整性，又无需引入原生模块或权限绕过方案，是构建跨平台图库功能的推荐实践。
