Firebase Cloud Storage getDownloadURL在iOS Capacitor本地环境失效

• 操作系统：iOS 16.5
• 浏览器版本：Capacitor iOS WebView
• Firebase SDK版本：9
• Firebase SDK产品：Storage
• 项目工具链：Ionic Angular Capacitor

执行ionic cap build ios后在Xcode中运行项目时，capacitor://localhost（原生应用）环境下调用getDownloadURL无任何输出，但用ionic cap run ios -l --external --open在http://localhost环境下可正常工作。

尝试过用then/catch和try/catch捕获输出，均无结果；查看库源码发现未抛出错误；尝试修改node_modules中的库文件，但受限于构建过程的摇树优化、压缩混淆及console.log移除，操作难度极大。已知Google可能不支持capacitor://localhost这类特殊协议，但当前近30%的应用依赖该协议，需要排查是否是白名单或存储权限问题，已连续调试10小时无果。

本地开发环境（http://localhost） #

getDownloadURL(storageRef)
  .then((res) => {
    console.log(res); // 正常输出
  })
  .catch((err) => {
    console.log(err); // 无输出
  });

原生应用环境（capacitor://localhost） #

getDownloadURL(storageRef)
  .then((res) => {
    console.log(res); // 无输出
  })
  .catch((err) => {
    console.log(err); // 无输出
  });

1. 检查Firebase存储CORS配置 #

Firebase Storage的CORS策略会限制非标准协议（如capacitor://）的请求。需配置CORS规则允许capacitor://localhost来源：
创建cors.json文件：

[
  {
    "origin": ["capacitor://localhost"],
    "method": ["GET"],
    "maxAgeSeconds": 3600
  }
]

执行命令上传配置：

gsutil cors set cors.json gs://<你的存储桶名称>

2. 配置Capacitor WebView允许列表 #

在capacitor.config.ts中添加capacitor://localhost到允许来源：

export default defineConfig({
  // ...其他配置
  server: {
    allowNavigation: ['capacitor://localhost']
  },
  ios: {
    contentSecurityPolicy: "default-src 'self' capacitor://localhost; img-src 'self' data: blob: https://firebasestorage.googleapis.com;"
  }
});

3. 调试原生WebView网络请求 #

在Xcode开发者工具中用Network Inspector查看请求状态：

• 运行应用后切换到Debug Navigator
• 选择Network标签，过滤Firebase相关请求，查看是否有403/401等错误状态码

4. 替换为自定义Scheme #

若capacitor://协议兼容性问题无法解决，可配置自定义Scheme：

export default defineConfig({
  server: {
    url: "myapp://localhost",
    cleartext: true
  }
});

同时更新Firebase CORS配置中的origin为myapp://localhost

5. 改用Firebase原生SDK #

集成Capacitor的Firebase Storage原生插件（如@capacitor-firebase/storage），绕过WebView协议限制：

import { FirebaseStorage } from '@capacitor-firebase/storage';

const getDownloadUrl = async (path: string) => {
  const result = await FirebaseStorage.getDownloadUrl({
    path: path,
  });
  console.log(result.downloadUrl);
};

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