Flutter Firebase开启AppCheck后通过getDownloadUrl访问Cloud Storage失败如何解决

官方内置方案说明 #

目前Firebase官方未提供getDownloadUrl()生成的下载链接自动附带AppCheck令牌的内置实现，开启AppCheck强制校验后，所有访问Storage资源的请求必须主动携带合法令牌才可通过校验。

标准请求头规范 #

AppCheck令牌需要放在X-Firebase-AppCheck请求头中传递，值为获取到的AppCheck令牌原始字符串即可，无需额外格式处理。

Flutter CachedNetworkImage无Firebase SDK实现思路 #

• 令牌获取：无需依赖Firebase SDK，可自行实现对应平台的AppCheck校验流程（iOS用Device Check/AppAttest、安卓用Play Integrity），调用AppCheck签发接口获取JWT格式的令牌，本地缓存备用。如果接受轻量依赖，也可以仅引入firebase_app_check包调用FirebaseAppCheck.instance.getToken()快速获取令牌，无需引入全量Firebase SDK。
• 请求头注入：直接使用CachedNetworkImage自带的httpHeaders参数传入配置好的请求头即可，示例代码如下：

CachedNetworkImage(
  imageUrl: "你的Cloud Storage资源下载链接",
  httpHeaders: <String, String>{
    "X-Firebase-AppCheck": "本地缓存的有效AppCheck令牌"
  },
  // 其余原有配置保持不变
  placeholder: (context, url) => const CircularProgressIndicator(),
  errorWidget: (context, url, error) => const Icon(Icons.error),
)

• 过期处理：AppCheck令牌默认有效期为1小时，可在令牌过期前10分钟左右主动重新获取新令牌替换旧值即可，无需每次请求都重新生成令牌。

补充说明：如果对应路径为公开访问资源，可在Storage安全规则中添加豁免规则，无需强制AppCheck校验即可直接访问。

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