Firebase Cloud文件名编码问题：Expo React Native获取冰岛语字符文件URL失败

问题根源是冰岛语字符（如ð、þ、æ、ö等）属于非ASCII字符，直接传入getDownloadURL时未做正确的百分号编码，导致服务端无法匹配到对应文件路径。

解决方案：对文件名/路径做针对性编码 #

核心是对路径中的每个文件名/目录段单独编码，保留路径分隔符/不被编码，避免破坏存储路径结构。

1. 编写编码工具函数

function encodeStoragePath(path) {
  // 拆分路径为单个文件名/目录段
  const segments = path.split('/');
  // 对每个段编码，保留路径分隔符
  const encodedSegments = segments.map(segment => encodeURIComponent(segment));
  return encodedSegments.join('/');
}

2. 在getDownloadURL调用中使用编码后的路径

// 原始含冰岛语字符的文件路径
const rawFilePath = 'photos/skjöldur-ðæöþ.jpg';
// 处理后的编码路径
const encodedPath = encodeStoragePath(rawFilePath);

// 初始化存储引用并获取下载URL
const storageRef = ref(storage, encodedPath);
getDownloadURL(storageRef)
  .then(downloadUrl => {
    // 成功获取URL后的逻辑
    console.log('下载URL:', downloadUrl);
  })
  .catch(err => {
    // 错误处理
    console.error('获取URL失败:', err);
  });

关键注意事项 #

• 用encodeURIComponent而非encodeURI：前者会编码所有非ASCII字符及特殊符号，确保服务端能正确解析冰岛语字符；后者仅编码部分字符，无法覆盖所有特殊场景。
• 不要编码完整路径：如果直接对包含/的完整路径编码，会导致路径分隔符被识别为文件名的一部分，进而触发“文件未找到”错误。
• 单独编码文件名：如果仅传入文件名而非完整路径，直接调用encodeURIComponent(filename)即可。

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